Reports API
Generate financial statements and aging reports.
Generated from the Celerp 2.4.0 OpenAPI schema, 16 September 2026.
GET /reports/ap-aging
Ap Aging
Accounts payable aging buckets per supplier (from purchase orders).
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful Response | object |
Example
curl -X GET http://localhost:8000/reports/ap-aging \
-H "Authorization: Bearer $TOKEN"GET /reports/ar-aging
Ar Aging
Accounts receivable aging buckets per customer.
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful Response | object |
Example
curl -X GET http://localhost:8000/reports/ar-aging \
-H "Authorization: Bearer $TOKEN"GET /reports/expiring
Expiring Items
Items expiring within `days` days, sorted by soonest first.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
days | query | -- | integer | -- |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful Response | object |
422 | Validation Error | HTTPValidationError |
Example
curl -X GET http://localhost:8000/reports/expiring \
-H "Authorization: Bearer $TOKEN"GET /reports/purchases
Purchases Report
Purchasing report from purchase order projections.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
group_by | query | -- | string | -- |
period | query | -- | string | -- |
date_from | query | -- | string, optional | -- |
date_to | query | -- | string, optional | -- |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful Response | object |
422 | Validation Error | HTTPValidationError |
Example
curl -X GET http://localhost:8000/reports/purchases \
-H "Authorization: Bearer $TOKEN"GET /reports/sales
Sales Report
Sales report from invoice projections. group_by=customer: revenue/cost/profit per customer. group_by=item: revenue/cost/profit per item (from line items). group_by=period: revenue/cost/profit aggregated by day/week/month.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
group_by | query | -- | string | -- |
period | query | -- | string | -- |
date_from | query | -- | string, optional | -- |
date_to | query | -- | string, optional | -- |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful Response | object |
422 | Validation Error | HTTPValidationError |
Example
curl -X GET http://localhost:8000/reports/sales \
-H "Authorization: Bearer $TOKEN"