---
title: "List transactions from a ledger"
method: GET
path: "/{ledger}/transactions"
tags: ["ledger.v1"]
---

# List transactions from a ledger

`GET /{ledger}/transactions`

List transactions from a ledger, sorted by txid in descending order.

## Path parameters

- `ledger` string, required

## Query parameters

- `pageSize` integer
- `page_size` integer
- `after` string
- `reference` string
- `account` string
- `source` string
- `destination` string
- `startTime` string, date-time
- `start_time` string, date-time
- `endTime` string, date-time
- `end_time` string, date-time
- `cursor` string
- `pagination_token` string
- `metadata` object

## Response `200`

OK

- TransactionsCursorResponse
  - `cursor` object, required — Paginated cursor wrapping the list of transactions
    - `pageSize` integer, required
    - `hasMore` boolean, required
    - `previous` string
    - `next` string
    - `data` Transaction[], required
      - `timestamp` string, date-time, required — The transaction time: when the transaction is considered to have occurred. See [bi-temporality](https://docs.formance.com/modules/ledger/working-with/bi-temporality)
      - `postings` Posting[], required — The fund movements making up the transaction
        - `amount` integer, required — Amount to move, as an arbitrary-precision integer expressed in the asset's smallest unit
        - `asset` string, required — The asset being moved, optionally carrying a scale suffix such as USD/2
        - `destination` string, required — Address of the account credited by this posting
        - `source` string, required — Address of the account debited by this posting
      - `reference` string — Optional caller-supplied identifier, unique within the ledger, used to deduplicate transactions
      - `metadata` Metadata, nullable — Arbitrary key/value pairs attached to the resource
      - `txid` integer, required — Unique sequential identifier for this transaction within the ledger
      - `preCommitVolumes` AggregatedVolumes — Volumes aggregated per account and per asset
      - `postCommitVolumes` AggregatedVolumes — Volumes aggregated per account and per asset

## 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)