Ledga
GET /accounts

List all accounts in a ledger

Cursor-paginated. tree=true returns the hierarchy unpaginated.

Parameters

NameInTypeDescription
type query string
enum: asset | liability | equity | revenue | expense
Filter by account type
active query boolean Filter by active status
parent_id query string
uuid
Filter by parent account UUID
search query string Search in code or name
tree query boolean
default: false
Return the whole chart of accounts as a tree of AccountTreeNode (not paginated; the other filters do not apply). A chart of more accounts than the configured cap (2000 by default) is refused with 422: read it page by page instead.
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: a page of Account, or with tree=true the root AccountTreeNode list and no meta
{
  "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",
      "parent_id": null,
      "code": "1000",
      "name": "Cash",
      "type": "asset",
      "category": "system",
      "normal_balance": "debit",
      "balance": "1000.00",
      "consolidated_balance": "1500.00",
      "description": null,
      "is_active": true,
      "is_system": false,
      "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"
}
404Ledger not found
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}
422A limit outside 1-100, a cursor the list did not issue, or a tree of more accounts than the cap
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}

Examples

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

← All endpoints