Ledger API
Event ledger API for reading Celerp business events and rebuilding derived application data.
Generated from the Celerp 2.5.0 OpenAPI schema, 21 September 2026.
GET /ledger
List Event Ledger Entries
Return event ledger entries matching the documented filters and pagination options.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
entity_id | query | -- | string, optional | Identifier of the requested Celerp record. |
entity_type | query | -- | string, optional | Business entity type used to filter ledger events. |
event_type | query | -- | string, optional | Event type used to filter ledger events. |
resolve | query | -- | boolean | Whether to include resolved entity information with ledger events when available. |
limit | query | -- | integer | Maximum number of records to return. |
offset | query | -- | integer | Number of matching records to skip before returning results. |
Responses
| Status | Description | Body |
|---|---|---|
200 | Returns the requested event ledger entries. | object |
422 | The request failed validation. The response lists each invalid field and why. | HTTPValidationError |
Example
curl -X GET http://localhost:8000/ledger \
-H "Authorization: Bearer $TOKEN"POST /ledger/rebuild
Rebuild Derived ERP Data
Rebuild all derived data, such as stock levels and balances, from the event history.
Responses
| Status | Description | Body |
|---|---|---|
200 | Returns `ok: true` once the rebuild finishes. | object |
Example
curl -X POST http://localhost:8000/ledger/rebuild \
-H "Authorization: Bearer $TOKEN"GET /ledger/{entry_id}
Get Event Ledger Entry
Return event ledger entry.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
entry_id | path | yes | integer | Identifier of the ledger entry. |
Responses
| Status | Description | Body |
|---|---|---|
200 | Returns the requested event ledger entry result. | object |
422 | The request failed validation. The response lists each invalid field and why. | HTTPValidationError |
Example
curl -X GET http://localhost:8000/ledger/:entry_id \
-H "Authorization: Bearer $TOKEN"