---
title: "GET /ledgers"
method: GET
path: "/ledgers"
---

# GET /ledgers

`GET /ledgers`

Returns an array of ledger summaries that are associated with the current Amazon Web Services account and Region.

This action returns a maximum of 100 items and is paginated so that you can retrieve all the items by calling `ListLedgers` multiple times.

## Query parameters

- `max_results` integer
- `next_token` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListLedgersResponse
  - `Ledgers` LedgerSummary[] — The array of ledger summaries that are associated with the current Amazon Web Services account and Region.
    - `Name` string — The name of the ledger.
    - `State` 'CREATING' | 'ACTIVE' | 'DELETING' | 'DELETED' — The current status of the ledger.
    - `CreationDateTime` string, date-time — The date and time, in epoch time format, when the ledger was created. (Epoch time format is the number of seconds elapsed since 12:00:00 AM January 1, 1970 UTC.)
  - `NextToken` string — <p>A pagination token, indicating whether there are more results available:</p> <ul> <li> <p>If <code>NextToken</code> is empty, then the last page of results has been processed and there are no more results to be retrieved.</p> </li> <li> <p>If <code>NextToken</code> is <i>not</i> empty, then there are more results available. To retrieve the next page of results, use the value of <code>NextToken</code> in a subsequent <code>ListLedgers</code> call.</p> </li> </ul>

---

[API](https://skmtc.net/aws/apis/qldb.md) · [All operations](https://skmtc.net/aws/apis/qldb/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/qldb/versions/40f98f4993d2/schema)