List transactions

Returns a paginated list of transactions for a ledger source. Either period_key or date_from/date_to must be provided.

Authorization

ApiKeyAuth

AuthorizationBearer <token>

Org-level API key (sk_live_*). Create keys from the dashboard at Settings → API Keys.

In: header

Path Parameters

id*string

Source UUID

Query Parameters

period_key?string

Filter to a single accounting period (YYYY-MM format)

date_from?string

Include transactions on or after this date (YYYY-MM-DD)

date_to?string

Include transactions on or before this date (YYYY-MM-DD)

direction?string

Filter by direction (debit or credit)

status?string

Filter by status (pending, posted, failed, reversed, void)

limit?integer

Maximum results per page (1–200)

Formatint64

Range1 <= value <= 200

Default50

offset?integer

Pagination offset

Formatint64

Range0 <= value

Default0

Response Body

`application/json`

`application/problem+json`

curl -X GET "https://example.com/ledger/sources/string/transactions"

{  "$schema": "/v1/schemas/ListTransactionsOutputBody.json",  "limit": 0,  "offset": 0,  "total": 0,  "transactions": [    {      "amountMinor": 150000,      "currency": "USD",      "date": "2026-06-15",      "direction": "string",      "id": "string",      "idempotencyKey": "string",      "ingestedAt": "2019-08-24T14:15:22Z",      "metadata": null,      "name": "string",      "orgId": "string",      "periodKey": "2026-06",      "raw": null,      "reference": "string",      "sourceId": "string",      "status": "string",      "transactionType": "string",      "valueDate": "string"    }  ]}

{  "$schema": "/v1/schemas/ErrorModel.json",  "detail": "Property foo is required but is missing.",  "errors": [    {      "location": "string",      "message": "string",      "value": null    }  ],  "instance": "https://example.com/error-log/abc123",  "status": 400,  "title": "Bad Request",  "type": "https://example.com/errors/example"}