Reports Endpoints

Export library operational data as CSV files. These endpoints generate downloadable reports for administrative analysis.

Base Path: /api/v1/reports

All endpoints require authentication and ROLE_ADMIN or ROLE_LIBRARIAN authorization.

Export Circulation Report

GET /api/v1/reports/circulation

Generates a CSV file containing the latest 1,000 circulation transactions. The response is a downloadable file with Content-Type: text/csv.

Authorization: ROLE_ADMIN, ROLE_LIBRARIAN

CSV Columns

Response

HTTP/1.1 200 OK
Content-Type: text/csv
Content-Disposition: attachment; filename="circulation_report.csv"

Transaction ID,User Name,User Email,Book Title,Barcode,Issued At,Due Date,Returned At
...

Export Fines Report

GET /api/v1/reports/fines

Generates a CSV file containing the latest 1,000 fine records. The response is a downloadable file with Content-Type: text/csv.

Authorization: ROLE_ADMIN, ROLE_LIBRARIAN

CSV Columns

Response

HTTP/1.1 200 OK
Content-Type: text/csv
Content-Disposition: attachment; filename="fines_report.csv"

Fine ID,User Name,Amount ($),Status,Reason,Created At,Updated At
...

Route Summary