GET
/transactions List all transactions in a ledger
Cursor-paginated, latest effective date first.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
layer | query | string enum: settled | pending | encumbrance | Filter by transaction layer, in any case |
status | query | string enum: posted | reversed | void | draft | pending | Filter by transaction status |
from_date | query | string date | Filter transactions from this effective date (YYYY-MM-DD, year 1 or later) |
to_date | query | string date | Filter transactions to this effective date (YYYY-MM-DD, year 1 or later) |
correlation_id | query | string max length: 50 | Only the transactions with this correlation handle: those given this correlation_id, and the one with this id that was given none |
limit | query | integer default: 25 · min: 1 · max: 100 | Items per page, 1 to 100. |
cursor | query | string | The previous page's meta.pagination.next_cursor; omit it for the first page. A cursor not shaped like this list's is a 422. |
Responses
200Successful operation
{
"success": true,
"meta": {
"pagination": {
"limit": 25,
"has_more": true,
"next_cursor": "eyJpZCI6IjAxOTk3YzFlLTRkMmEtN2MzZS05YTFiLTJmMGU4YzZkNGI1YSJ9",
"previous_cursor": null
}
},
"data": [
{
"id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
"ledger_id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
"journal_id": null,
"reference": "INV-001",
"description": "Payment received",
"effective_date": "2026-01-15T10:30:00Z",
"date": "2026-01-15T10:30:00Z",
"layer": "settled",
"status": "posted",
"total_amount": "100.00",
"entry_count": 2,
"hash": null,
"previous_hash": null,
"correlation_id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
"correlation_source_id": null,
"correlation_type": null,
"metadata": null,
"attributes": {
"customer_id": "C-123",
"loan_id": "L-42"
},
"original_transaction_id": null,
"reversal_reason": null,
"voided_by": null,
"voided_at": null,
"void_reason": null,
"entries": [
{
"id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
"account_id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
"account_code": "1000",
"account_name": "Cash",
"amount": "100.00",
"type": "debit",
"description": null,
"layer": "settled",
"metadata": null
}
],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-01-15T10:30:00Z"
}
]
} 401Unauthenticated
{
"success": false,
"message": "Validation failed",
"code": "VALIDATION_ERROR"
} 403Forbidden
{
"success": false,
"message": "Validation failed",
"code": "VALIDATION_ERROR"
} 422Validation error (layer or status not one of its values, from_date or to_date not a YYYY-MM-DD date from year 1, or correlation_id not UTF-8 text of at most 50 characters); or a cursor not shaped like this list's
{
"success": false,
"message": "Validation failed",
"code": "VALIDATION_ERROR"
} Examples
curl https://ledga.io/api/v1/transactions \
-H "Authorization: Bearer sk_xxxxxxxx_your_secret" use Ledga\Api\LedgaClient;
$ledga = new LedgaClient('sk_xxxxxxxx_your_secret');
$page = $ledga->transactions->list(['status' => 'posted', 'limit' => 50]);