---
title: "Get a ledger"
method: GET
path: "/v2/{ledger}"
tags: ["ledger.v2"]
---

# Get a ledger

`GET /v2/{ledger}`

## Response `200`

OK

- V2GetLedgerResponse
  - `data` V2Ledger, required — A ledger and its configuration
    - `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)