---
title: "List accounts from a ledger"
method: GET
path: "/{ledger}/accounts"
tags: ["ledger.v1"]
---

# List accounts from a ledger

`GET /{ledger}/accounts`

List accounts from a ledger, sorted by address in descending order.

## Path parameters

- `ledger` string, required

## Query parameters

- `pageSize` integer
- `page_size` integer
- `after` string
- `address` string
- `metadata` object
- `balance` integer
- `balanceOperator` 'gte' | 'lte' | 'gt' | 'lt' | 'e' | 'ne'
- `balance_operator` 'gte' | 'lte' | 'gt' | 'lt' | 'e' | 'ne'
- `cursor` string
- `pagination_token` string

## Response `200`

OK

- AccountsCursorResponse
  - `cursor` object, required
    - `pageSize` integer, required
    - `hasMore` boolean, required
    - `previous` string
    - `next` string
    - `data` Account[], required
      - `address` string, required
      - `type` string
      - `metadata` object

## Other responses

- `404` — Not found
- `default` — Error

---

[API](https://skmtc.dev/formancehq/apis/ledger-api.md) · [All operations](https://skmtc.dev/formancehq/apis/ledger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/formancehq/ledger-api/revisions/5586071dbca0/schema)
