Estimate a fiat withdrawal fee

GET

/v1/wallet/fiat/{currency}/withdraw/estimate-fee

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

Returns the fee for withdrawing amount to a bank account linked to the account (the primary, or the sub-account selected with X-VALR-SUB-ACCOUNT-ID). The fee is charged on top, so the account is debited fullAmount plus feeAmount.

Parameters

Path Parameters

currency*

Fiat currency to withdraw, e.g. ZAR.

Type

string

Required

Example"ZAR"

Query Parameters

linkedBankAccountId*

ID of the bank account to withdraw to.

Type

string

Required

Example"3c9e1f42-7d5b-4a8e-9f21-6b0d8c4e7a15"

Format

"uuid"

amount*

Amount to withdraw, as a decimal string.

Type

string

Required

Example"1500"

fast

true to price a fast (RTC or RTGS) withdrawal.

Type

boolean

Examplefalse

Default

false

Responses

OK

Content-Type

application/json

{

"feeAmount": "8.50",

"fullAmount": "1500.00",

"fast": false

}

Samples

Errors

HTTP	Error	When
400	-11INVALID_REQUEST	linkedBankAccountId is missing or isn't a UUID, amount is missing or isn't a number, fast isn't true or false, or the currency isn't recognised.
404	-14203COULD_NOT_GET_LINKED_ACCOUNT	No bank account with this ID exists.

Plus the errors common to all signed endpoints.