---
title: "List transactions"
method: POST
path: "/api/service/transaction/list"
tags: ["Transactions"]
---

# List transactions

`POST /api/service/transaction/list`

Retrieve a paginated list of transactions for the specified time period

## Request body

- ListTransactionsDto
  - `from` number, required — Start timestamp (inclusive) - unix timestamp
  - `to` number, required — End timestamp (exclusive) - unix timestamp
  - `afterCursor` string — Cursor for pagination

## Response `200`

The list of transactions

- ListTransactionsResponseDto
  - `data` object[], required — Array of transactions
    - `id` string, required — Transaction identifier
    - `amount` string, required — Amount of the transaction
    - `currency` string, required — ISO 4217 currency code
    - `side` 'credit' | 'debit', required — Side of the transaction
    - `creditor` object, required — Creditor account details
      - `type` 'iban' | 'sort_code' | 'bank_code' | 'bban' | 'wallet', required — Type of financial address
      - `iban` object
        - `iban` string, required
        - `bic` string
        - `accountHolderName` string, required
      - `sortCode` object
        - `sortCode` string, required
        - `accountNumber` string, required
        - `accountHolderName` string, required
      - `bankCode` object
        - `accountNumber` string, required
        - `code` string, required
        - `accountHolderName` string, required
      - `bban` object
        - `bban` string, required
        - `accountHolderName` string, required
        - `bic` string
      - `wallet` object
        - `address` string, required — The blockchain wallet address
    - `debtor` object, required — Debtor account details
      - `type` 'iban' | 'sort_code' | 'bank_code' | 'bban' | 'wallet', required — Type of financial address
      - `iban` object
        - `iban` string, required
        - `bic` string
        - `accountHolderName` string, required
      - `sortCode` object
        - `sortCode` string, required
        - `accountNumber` string, required
        - `accountHolderName` string, required
      - `bankCode` object
        - `accountNumber` string, required
        - `code` string, required
        - `accountHolderName` string, required
      - `bban` object
        - `bban` string, required
        - `accountHolderName` string, required
        - `bic` string
      - `wallet` object
        - `address` string, required — The blockchain wallet address
    - `balance` object, required — Balance information
      - `before` string, required — Balance before the transaction
      - `after` string, required — Balance after the transaction
    - `bankStatementReference` string, required — Bank statement reference
    - `transactionDate` number, required — Transaction date as unix timestamp
  - `paging` object, required — Pagination information
    - `hasNext` boolean, required — Whether there are more transactions available
    - `nextCursor` string — Cursor for the next page of results

## Changes

- **2025-11-13** `8db8d1e5025b` — 3 breaking, 1 warning, 3 info
  - added the new required request property `from`
  - added the new required request property `to`
  - removed the required property `transactions` from the response with the `200` status
  - removed the request property `sessionId`
  - …3 more
- **2025-10-28** `cfd7b0e0db80` — 3 breaking, 3 warning, 1 info
  - added the new required request property `sessionId`
  - removed the required property `data` from the response with the `200` status
  - removed the required property `paging` from the response with the `200` status
  - removed the request property `afterCursor`
  - …3 more
- **2025-10-17** `102fab1c7e1a` — 2 warning
  - added the new `wallet` enum value to the `data/items/creditor/type` response property for the response status `200`
  - added the new `wallet` enum value to the `data/items/debtor/type` response property for the response status `200`

[Change history](https://skmtc.dev/augustus/apis/ivy-api/changes/api/service/transaction/list/post.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) · [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/67331c93ebb1/schema)