---
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 — Paginated cursor wrapping the list of accounts
    - `pageSize` integer, required
    - `hasMore` boolean, required
    - `previous` string
    - `next` string
    - `data` Account[], required
      - `address` string, required — The account address, a colon-separated segmented path such as users:001
      - `type` string — Free-form classification of the account
      - `metadata` object — Arbitrary key/value pairs attached to the account

## Other responses

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

## Changes

- **2024-11-26** `bb0f59cb5e25` — 2 breaking
  - for the `query` request parameter `pageSize`, default value `15` was removed
  - for the `query` request parameter `page_size`, default value `15` was removed

[Change history](https://skmtc.dev/formancehq/apis/ledger-api/changes/:ledger/accounts/get.md)

---

[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/fe945da1b75d/schema)