---
title: "Find transactions for account."
method: POST
path: "/v3/ledger/transaction/account"
tags: ["Transaction"]
---

# Find transactions for account.

`POST /v3/ledger/transaction/account`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v3/ledger/transaction/account`
- Auth: API key in header `x-api-key`

/v3/ledger/transaction/account

#### 1 credit per API call.

  

Finds transactions for the account identified by the given account ID.

## Query parameters

- `pageSize` number
- `offset` number
- `count` boolean

## Request body

- TransactionFilter
  - `id` string, required: Account ID - source of transaction(s).
  - `counterAccount` string: Counter account - transaction(s) destination account.
  - `from` integer: Starting date to search for transactions from in UTC millis. If not present, search all history.
  - `to` integer: Date until to search for transactions in UTC millis. If not present, search up till now.
  - `currency` string: Currency of the transactions.
  - `amount` object[]: Amount of the transaction. AND is used between filter options.
    - `op` 'gte' | 'lte' | 'gt' | 'lt' | 'eq' | 'neq', required: Filtering operation.
    - `value` string, required: Value of the operation.
  - `currencies` string[]: List of currencies of the transactions.
  - `transactionType` 'FAILED' | 'DEBIT_PAYMENT' | 'CREDIT_PAYMENT' | 'CREDIT_DEPOSIT' | 'DEBIT_WITHDRAWAL' | 'CANCEL_WITHDRAWAL' | 'DEBIT_OUTGOING_PAYMENT' | 'EXCHANGE_BUY' | 'EXCHANGE_SELL' | 'DEBIT_TRANSACTION' | 'CREDIT_INCOMING_PAYMENT': Type of payment
  - `transactionTypes` string[]: Types of payment
  - `opType` 'PAYMENT' | 'WITHDRAWAL' | 'BLOCKCHAIN_TRANSACTION' | 'EXCHANGE' | 'FAILED' | 'DEPOSIT' | 'MINT' | 'REVOKE': Type of operation
  - `transactionCode` string: For bookkeeping to distinct transaction purpose.
  - `paymentId` string: Payment ID defined in payment order by sender.
  - `recipientNote` string: Recipient note defined in payment order by sender.
  - `senderNote` string: Sender note defined in payment order by sender.

## Response `200`

OK

- union
  - Transaction[]
    - `accountId` string, required: Source account - source of transaction(s)
    - `counterAccountId` string: Counter account - transaction(s) destination account. In case of blockchain recipient, this is addess of blockchain account.
    - `currency` string, required: Transaction currency
    - `amount` string, required: Amount in account's currency
    - `anonymous` boolean, required: Whether the transaction is anonymous. If true, counter account owner does not see source account.
    - `created` number, required: Time in UTC of transaction.
    - `marketValue` object, required: FIAT value of transaction.
      - `amount` string, required: Value of transaction in given base pair.
      - `currency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'ALGO' | 'ADA' | 'BAM' | 'BAT' | 'BBD' | 'BCH' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BNB' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTC' | 'BTN' | 'BWP' | 'BYN' | 'BYR' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DOGE' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'ETH' | 'EUR' | 'FJD' | 'FKP' | 'FREE' | 'GMC' | 'GMC_BSC' | 'RMD' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LEO' | 'LINK' | 'LKR' | 'LRD' | 'LSL' | 'LTC' | 'LTL' | 'LVL' | 'LYD' | 'MAD' | 'MATIC' | 'MDL' | 'MGA' | 'MKD' | 'MKR' | 'MMK' | 'MMY' | 'MNT' | 'MOP' | 'MRO' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PAX' | 'PAXG' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLL' | 'SOS' | 'SRD' | 'STD' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TRON' | 'TUSD' | 'BUSD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'UNI' | 'USD' | 'USDC' | 'USDC_MATIC' | 'USDC_MATIC_NATIVE' | 'USDT' | 'USDT_TRON' | 'USDT_MATIC' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'VUV' | 'WBTC' | 'WST' | 'XAF' | 'XAG' | 'XAU' | 'XCD' | 'XCON' | 'XDR' | 'XOF' | 'XPF' | 'XRP' | 'YER' | 'ZAR' | 'ZMK' | 'ZMW' | 'ZWL', required
      - `sourceDate` number, required: Date of validity of rate in UTC.
      - `source` string, required: Source of base pair.
    - `operationType` 'PAYMENT' | 'WITHDRAWAL' | 'BLOCKCHAIN_TRANSACTION' | 'EXCHANGE' | 'FAILED' | 'DEPOSIT' | 'MINT' | 'REVOKE', required: Type of operation.
    - `transactionType` 'FAILED' | 'DEBIT_PAYMENT' | 'CREDIT_PAYMENT' | 'CREDIT_DEPOSIT' | 'DEBIT_WITHDRAWAL' | 'CANCEL_WITHDRAWAL' | 'DEBIT_OUTGOING_PAYMENT' | 'CREDIT_INCOMING_PAYMENT' | 'EXCHANGE_BUY' | 'EXCHANGE_SELL', required: Type of payment.
    - `reference` string, required: Transaction internal reference - unique identifier within Tatum ledger. In order of failure, use this value to search for problems.
    - `transactionCode` string: For bookkeeping to distinct transaction purpose.
    - `senderNote` string: Note visible for sender.
    - `recipientNote` string: Note visible for both sender and recipient.
    - `paymentId` string: Payment ID defined in payment order by sender.
    - `attr` string: Present only for operationType WITHDRAWAL and XLM / XRP based accounts it represents message or destinationTag of the recipient, if present.
    - `address` string: For operationType DEPOSIT it represents address, on which was deposit credited for the account.
    - `txId` string: For operationType DEPOSIT, BLOCKCHAIN_TRANSACTION it represents transaction id, for which deposit occured.
  - number: Total transaction count.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/tatum/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/virtual-accounts/revisions/ba220553084b?raw)