Initiate a fiat withdrawal

POST

/v1/fiat-transfers/withdrawals

Initiates a fiat withdrawal for a user to a registered payout account.

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

Request

Authorization

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Success Response (Created)

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

🟠422Parameter Error

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

curl --location 'https://test.whitelabel.bitpanda.com/v1/fiat-transfers/withdrawals' \
--header 'bp-user-id: 12312312-2be6-4522-977e-ea4d92c45e86' \
--header 'Idempotency-Key: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
--header 'Content-Type: application/json' \
--data '{
    "amount": "100.50",
    "payout_account_id": "4fbc982a-d8f3-431a-8f14-3ed5d8f23312",
    "verification_id": "9ab1c2d3-e4f5-6789-abcd-ef0123456789"
}'

Response Example

201 - Example 1

{
    "data": {
        "id": "1ee9f3e7-74f6-69d4-ab33-f11031b04ebc",
        "fiat_id": "4fbc982a-d8f3-431a-8f14-3ed5d8f23312",
        "amount": "100.50",
        "fee": "1.50",
        "status": "initiated"
    }
}

Modified at 2026-07-21 14:05:14

Update a verification

Get fiat transfer fees