---
title: "List Ledgers"
method: GET
path: "/v1/organizations/{organization_id}/ledgers"
tags: ["Ledgers API"]
---

# List Ledgers

`GET /v1/organizations/{organization_id}/ledgers`

Use this endpoint to retrieve the details of all the Ledgers in an Organization.

## Path parameters

- `organization_id` string, uuid, required

## Query parameters

- `limit` integer
- `start_date` string
- `end_date` string
- `sort_order` 'asc' | 'desc'
- `page` integer
- `metadata.key` string
- `name` string
- `status` 'ACTIVE' | 'INACTIVE'

## Headers

- `Content-Type` string
- `X-Request-Id` string, uuid
- `Authorization` string

## Response `200`

Indicates that the request was successful and the response contains the expected data.

- object
  - `items` CreateLedgerResponse[]
    - `id` string, uuid — The unique identifier of the Ledger.
    - `organizationId` string, uuid — The unique identifier of the Organization.
    - `name` string — The name of the Ledger.
    - `status` StatusOrganization — An object containing information about the status.
      - `code` string — The name of the status.
      - `description` string, nullable — The description of the status.
    - `metadata` Metadata — An object containing key-value pairs to add as metadata, where the field `name` is the key and the field `value` is the value. For example, to add a Cost Center, use `'costCenter': 'BR_11101997'`. **Constraints:** keys must be at most 100 characters; string values at most 2000 characters. Nested objects are not allowed (values must be string, number, or boolean), the structure may not exceed a maximum depth of 10, and a maximum of 100 keys is permitted.
    - `settings` LedgerSettingsResponse — The current settings of a Ledger.
      - `accounting` object — Accounting-related settings for the Ledger.
        - `validateAccountType` boolean — When enabled, validates that account types match the rules defined in operation routes during transaction processing.
        - `validateRoutes` boolean — When enabled, every transaction in this Ledger must have an associated transaction route. Operations are also validated against their operation route rules.
    - `createdAt` string, date-time — Timestamp of creation (UTC).
    - `updatedAt` string, date-time — Timestamp of last update (UTC).
    - `deletedAt` string, date-time, nullable — Timestamp of soft deletion, if applicable (UTC).
  - `page` integer — The number of pages returned.
  - `limit` integer — The maximum number of items included in the response.

## Other responses

- `400`
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)