Retrieve Transactions and Withdrawals

❗️
Attention
Access to this feature is limited to existing Virtual Account users on PayGo and higher tiers who registered before November 24, 2025

List all End User transactions for a customerId

v3 REST API endpoint

Request Example:

curl --request POST \
     --url 'https://api.tatum.io/v3/ledger/transaction/customer?pageSize=50&offset=0' \
     --header 'x-api-key: {YOUR_API_KEY}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
               "id":"5fb7bdf6e96d9ab593e191a6" //Here the "customerId"
       }'
//Response:
[
    {
        "amount": "0.001",
        "operationType": "DEPOSIT",
        "currency": "BTC",
        "transactionType": "CREDIT_DEPOSIT",
        "accountId": "5fb7bdf6e96d9ab593e191a5",
        "anonymous": false,
        "reference": "c81a23dd-e162-4e0b-b0ff-e470c64f7b88",
        "txId": "cd63e729ecc513bc22e8632b69a433126d5621c5f11047f34a0cbe144ce9aaac",
        "address": "n22crsZTASULKtLqg3XzD1NwV1HnfrQpcd",
        "marketValue": {
            "currency": "EUR",
            "source": "CoinGecko",
            "sourceDate": 1606164328453,
            "amount": "15.49693999999999884022"
        },
        "created": 1606164532855
    }
]

List transactions

v3 REST API endpoint

Request Example:

curl --request POST \
     --url 'https://api.tatum.io/v3/ledger/transaction/ledger?pageSize=50&offset=0' \
     --header 'x-api-key: {YOUR_API_KEY}'\
     --header 'accept: application/json' \
     --header 'content-type: application/json' \

List withdrawals

v3 REST API endpoint

Request Example:

curl --request GET \
     --url 'https://api.tatum.io/v3/offchain/withdrawal?currency=BTC&status=InProgress&pageSize=50&offset=0' \
     --header 'x-api-key: {YOUR_API_KEY}' \   
     --header 'accept: application/json' \