---
title: "List ledgers"
method: GET
path: "/v2"
tags: ["ledger.v2"]
---

# List ledgers

`GET /v2`

## Query parameters

- `pageSize` integer
- `cursor` string
- `includeDeleted` boolean
- `sort` string

## Request body

- object

## Response `200`

OK

- V2LedgerListResponse
  - `cursor` object, required — Paginated cursor wrapping the list of ledgers
    - `pageSize` integer, required
    - `hasMore` boolean, required
    - `previous` string
    - `next` string
    - `data` V2Ledger[], required
      - `name` string, required — Name of the ledger
      - `addedAt` string, date-time, required — When the ledger was created
      - `bucket` string, required — Name of the storage bucket backing the ledger
      - `deletedAt` string, date-time, nullable — When the ledger was deleted, absent for active ledgers
      - `metadata` V2Metadata — Arbitrary key/value pairs attached to the resource. Metadata is bi-temporal, so a point-in-time query returns the metadata as it stood at that time
      - `features` object — Feature flags enabled on the ledger, keyed by feature name
      - `id` integer — Unique sequential identifier for the ledger

## Other responses

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