GET
/accounts List all accounts in a ledger
Cursor-paginated. tree=true returns the hierarchy unpaginated.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
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" use Ledga\Api\LedgaClient;
$ledga = new LedgaClient('sk_xxxxxxxx_your_secret');
$page = $ledga->accounts->list(['type' => 'asset', 'limit' => 25]);
foreach ($ledga->accounts->all() as $account) { /* every page */ }