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

# List transaction history

`POST /api/service/transaction/list`

Retrieve a paginated list of transactions for the specified time period

## Request body

- ListTransactionsDto
  - `accountId` string, uuid — Account Id to fetch transactions for. Optional, is not specified - transactions for the default accounts will be returned
  - `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

- ListTransactionsExternalResponseDto
  - `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' | 'aba', 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' | 'aba', 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
    - `paymentProcessId` string — Identifier of the associated payment process (e.g. deposit, payout, refund). Use together with paymentProcessType for reconciliation
    - `paymentProcessType` 'deposit' | 'deposit_return' | 'payout' | 'merchant_payout' | 'payment' | 'refund' | 'fxQuote' | 'payoutv2' | 'walletVerification' | 'topup' — Payment process type
  - `paging` object, required — Pagination information
    - `hasNext` boolean, required — Whether there are more transactions available
    - `nextCursor` string — Cursor for the next page of results

---

[API](https://skmtc.net/augustus/apis/ivy-api.md) · [All operations](https://skmtc.net/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/augustus/ivy-api/versions/c3055fc06ca3/schema)