List all fiat transfers per user

GET

/v1/fiat-transfers/transactions

This endpoint retrieves a paginated list of all fiat transactions, including deposits and withdrawals, for a specified user.

It allows filtering by transaction attributes like type, status, fiat currency, and date range, providing flexibility to view and manage transaction history efficiently.

Results are returned newest-first and paginated using a cursor. To fetch the next page, pass the id of the last item from the current page as the cursor with direction=after.

Status changes throughout the lifecycle of each transaction are notified asynchronously through the Fiat Transfer Update webhook.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Header Params

Responses

🟢200OK

application/json

Success Response

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

curl --location --globoff 'https://test.whitelabel.bitpanda.com/v1/fiat-transfers/transactions?id=1ee9f3e7-74f6-69d4-ab33-f11031b04ebc&fiat_id=4fbc982a-d8f3-431a-8f14-3ed5d8f23312&status[]=finished&type=deposit&date_start=2025-04-01&date_end=2025-04-30&size=10&cursor=1ee9f3e7-74f6-69d4-ab33-f11031b04ebc&direction=undefined' \
--header 'bp-user-id: 12312312-2be6-4522-977e-ea4d92c45e86' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": [
        {
            "id": "1ee9f3e7-74f6-69d4-ab33-f11031b04ebc",
            "type": "deposit",
            "status": "initiated",
            "fiat_id": "4fbc982a-d8f3-431a-8f14-3ed5d8f23312",
            "amount": "100.50",
            "fee": "1",
            "payout_account_id": null,
            "created_at": "2025-04-11T08:09:07Z",
            "credited_at": null,
            "finished_at": "2025-04-11T08:15:00Z",
            "rejected_at": null,
            "rejection_error_code": "insufficient.funds",
            "refunded_at": null
        }
    ],
    "meta": {
        "size": 10
    }
}

Modified at 2026-07-24 10:22:43

Initiate a fiat withdrawal

Get fiat transfer fees