---
title: "Get a schema for a ledger by version"
method: GET
path: "/v2/{ledger}/schemas/{version}"
tags: ["ledger.v2"]
---

# Get a schema for a ledger by version

`GET /v2/{ledger}/schemas/{version}`

## Response `200`

Schema retrieved successfully

- V2SchemaResponse
  - `data` V2Schema, required — Schema data structure for ledger schemas
    - `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

## Other responses

- `default` — Error

## Changes

- **2026-06-09** `5b3ac7d993a2` — 1 breaking, 2 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `data/allOf[#/components/schemas/V2SchemaData]/queries/additionalProperties/params` response property `oneOf` list for the response status `200`
  - added discriminator to `data/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 `data/allOf[#/components/schemas/V2SchemaData]/queries/additionalProperties/params` response property `oneOf` list for the response status `200`
- **2026-03-25** `3ef3cb98f97a` — 1 breaking
  - the `data/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 `data/allOf[#/components/schemas/V2SchemaData]/transactions` became optional for the status `200`
- **2026-02-20** `c0620f81a649` — 1 info
  - added the optional property `data/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/:version/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)