GET
/transactions/correlation List transactions sharing a correlation ID (chronological)
Returns every transaction in this ledger with the correlation handle correlation_id, oldest first (posting order). The handle is a correlation_id the transactions were given, or the id of a transaction given none: the correlation_id its 202 returned. It is a query parameter, so any value the write API accepts round-trips. An unknown handle, or another ledger's, returns an empty page, not 404.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
correlation_idrequired | query | string max length: 50 | The correlation handle: a correlation_id the transactions were given, or the id of a transaction given none (the handle its 202 returned) |
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 (empty data when no transactions share the id)
{
"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 (correlation_id missing, over 50 characters or not UTF-8 text); 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/correlation?correlation_id=01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a \
-H "Authorization: Bearer sk_xxxxxxxx_your_secret" use Ledga\Api\LedgaClient;
$ledga = new LedgaClient('sk_xxxxxxxx_your_secret');
$page = $ledga->transactions->byCorrelation('INVOICE-42', ['limit' => 25]);
foreach ($ledga->transactions->allByCorrelation('INVOICE-42') as $transaction) { /* every page, oldest first */ }