paytrack docs
Ledger
Inspect tamper-evident finance events for workspaces, customers, and tracks.
Overview
The ledger records important finance events with cryptographic hashes so teams can review integrity and detect tampering. Use it for audits, dispute review, and admin oversight.
Required scope
ledger:readEndpoints
Operations
Available API methods for this resource.
GET/api/v1/ledgerList workspace ledger events.
GET/api/v1/customers/{id}/ledgerList ledger events for one customer.
GET/api/v1/tracks/{id}/ledgerList ledger events for one track.
Request example
Example
curl https://paytrack.ng/api/v1/ledger \ -H "Authorization: Bearer $PAYTRACK_API_KEY"
Response example
Example
{
"success": true,
"data": [
{
"id": "led_123",
"event": "payment.recorded",
"hash": "a3f...",
"createdAt": "2026-07-08T10:00:00.000Z"
}
],
"request_id": "req_xxx"
}Error example
Example
{
"success": false,
"error": {
"code": "validation_error",
"message": "The request failed validation.",
"details": {}
},
"request_id": "req_xxx"
}