Business API

Appearance

Get a fiat withdrawal​

GET
/v1/wallet/fiat/{currency}/withdrawals/{id}

Requires WITHDRAWALS_READ, granted by TREASURY_READ or TREASURY_WRITE or WITHDRAWALS_WRITE or BANK_ACCOUNTS_WRITE (bundles)

Returns a fiat withdrawal with the bank account it was paid to, its fee and, if it was reversed, the amounts returned. It must belong to the account (the primary, or the sub-account selected with X-VALR-SUB-ACCOUNT-ID), unless includeAllSubAccounts applies.

Parameters​

Path Parameters

currency*

Fiat currency of the withdrawal, e.g. ZAR.

Type
string
Required
Example"ZAR"
id*

Withdrawal ID: the id returned when the withdrawal was created.

Type
string
Required
Example"d4a7c2e9-61f3-4b8d-9e05-7c1b3f6a2d84"
Format
"uuid"

Query Parameters

includeAllSubAccounts

true to find the withdrawal on the primary or any sub-account apart from hidden ones. Only applies when you don't send X-VALR-SUB-ACCOUNT-ID and the key isn't restricted to sub-accounts; otherwise it's ignored.

Type
boolean
Examplefalse
Default
false

Responses​

OK

application/json
JSON
{
"id": "d4a7c2e9-61f3-4b8d-9e05-7c1b3f6a2d84",
"subAccountId": "0",
"currency": "ZAR",
"amount": "1500.00",
"status": "PAID",
"isFast": false,
"createdAt": "2026-10-23T08:30:05.272523Z",
"updatedAt": "2026-10-23T11:02:41.167902Z",
"linkedBankAccount": {
"id": "3c9e1f42-7d5b-4a8e-9f21-6b0d8c4e7a15",
"bankCode": "FNB",
"bankName": "FNB/RMB",
"accountHolder": "Acme Trading (Pty) Ltd",
"accountNumber": "62792461544",
"branchCode": "250655",
"accountType": "Current/Cheque",
"status": "VERIFIED",
"insertedAt": "2026-08-14T09:21:37.408215Z",
"updatedAt": "2026-08-14T09:23:02.115480Z",
"country": "ZA",
"currency": {
"symbol": "R",
"decimalPlaces": 2,
"isActive": true,
"shortName": "ZAR",
"longName": "Rand",
"supportedWithdrawDecimalPlaces": 2,
"collateral": true,
"collateralWeight": "1"
}
},
"reference": "INV 2026-0142",
"feeAmount": "8.50"
}

Samples​

Errors

HTTPErrorWhen
400-11INVALID_REQUESTThe withdrawal ID isn't a valid UUID, includeAllSubAccounts isn't true or false, or the currency isn't recognised.
404-15300COULD_NOT_FIND_FIAT_WITHDRAWALNo withdrawal in this currency with this ID exists on the account, or on any of your business's visible accounts when includeAllSubAccounts applies.

Plus the errors common to all signed endpoints.