Ledga
GET/transactions

List all transactions in a ledger

Cursor-paginated, newest first.

Parameters

NameInTypeDescription
layer query string
enum: settled | pending | encumbrance
 Filter by transaction layer
status query string
enum: pending | posted | void | failed | reversed
 Filter by transaction status
from_date query string
date
 Filter transactions from this date
to_date query string
date
 Filter transactions to this date
correlation_id query string Filter by correlation ID
limit query integer
default: 25 · max: 100
 Number of items per page (max 100)
cursor query string Cursor for pagination

Responses

200Successful operation 
{
  "success": true,
  "meta": {
    "pagination": {
      "limit": 25,
      "has_more": true,
      "next_cursor": "eyJpZCI6IjAxOWRjZjg3LTUwN2ItNzE5OS05ZTE1LWZhY2YxNjVlNzRjMSJ9"
    }
  },
  "data": [
    {
      "id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
      "ledger_id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
      "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,
      "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",
          "layer": "settled"
        }
      ],
      "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"
}

Examples

curl https://ledga.io/api/v1/transactions \
  -H "Authorization: Bearer sk_xxxxxxxx_your_secret"

← All endpoints