---
title: "List all schemas for a ledger"
method: GET
path: "/v2/{ledger}/schemas"
tags: ["ledger.v2"]
---

# List all schemas for a ledger

`GET /v2/{ledger}/schemas`

## Query parameters

- `cursor` string
- `pageSize` integer
- `sort` 'created_at'
- `order` 'asc' | 'desc'

## Response `200`

Schemas retrieved successfully

- V2SchemasCursorResponse
  - `cursor` V2SchemasCursor, required — Paginated cursor over the ledger's schemas
    - `data` V2Schema[], required — The schemas on this page
      - `version` string, required — Schema version
      - `createdAt` string, date-time, required — Schema creation timestamp
      - `chart` V2ChartOfAccounts, required — Chart of account
      - `transactions` V2TransactionTemplates — Transaction templates
      - `queries` V2QueryTemplates — Query templates
    - `hasMore` boolean, required — Whether further pages are available
    - `previous` string — Cursor for the previous page, absent on the first page
    - `next` string — Cursor for the next page, absent on the last page
    - `pageSize` integer, required — Number of items requested per page

## Other responses

- `default` — Error

## Changes

- **2026-06-09** `5b3ac7d993a2` — 1 breaking, 2 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `cursor/data/items/allOf[#/components/schemas/V2SchemaData]/queries/additionalProperties/params` response property `oneOf` list for the response status `200`
  - added discriminator to `cursor/data/items/allOf[#/components/schemas/V2SchemaData]/queries/additionalProperties/params` response property for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `cursor/data/items/allOf[#/components/schemas/V2SchemaData]/queries/additionalProperties/params` response property `oneOf` list for the response status `200`
- **2026-03-25** `3ef3cb98f97a` — 1 breaking
  - the `cursor/data/items/allOf[#/components/schemas/V2SchemaData]/queries/additionalProperties/params/sort` response's property type/format changed from ``/`` to `string`/`` for status `200`
- **2026-02-23** `0f0824721b6e` — 1 breaking
  - the response property `cursor/data/items/allOf[#/components/schemas/V2SchemaData]/transactions` became optional for the status `200`
- **2026-02-20** `c0620f81a649` — 1 info
  - added the optional property `cursor/data/items/allOf[#/components/schemas/V2SchemaData]/queries` to the response with the `200` status
- **2026-02-19** `58667a80ce17` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/formancehq/apis/ledger-api/changes/v2/:ledger/schemas/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)