Get a bank account

GET

/v1/wallet/fiat/{currency}/accounts/{id}

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

Returns a bank account linked to the account (the primary, or the sub-account selected with X-VALR-SUB-ACCOUNT-ID).

Parameters

Path Parameters

currency*

Fiat currency, e.g. ZAR.

Type

string

Required

Example"ZAR"

id*

Bank account ID: the id returned when it was linked or listed.

Type

string

Required

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

Format

"uuid"

Responses

OK

Content-Type

application/json

{

"id": "3c9e1f42-7d5b-4a8e-9f21-6b0d8c4e7a15",

"bank": "FNB/RMB",

"accountHolder": "Acme Trading (Pty) Ltd",

"accountNumber": "62792461544",

"branchCode": "250655",

"accountType": "Current/Cheque",

"createdAt": "2026-08-14T09:21:37.408215Z",

"country": "ZA"

}

Samples

Errors

HTTP	Error	When
400	-11INVALID_REQUEST	The currency isn't recognised or the bank account ID isn't a valid UUID.
404	-14203COULD_NOT_GET_LINKED_ACCOUNT	No bank account with this ID is linked to the account.
451	-15320FIAT_WITHDRAWALS_NOT_ALLOWED_FOR_CURRENCY	Your business's region doesn't allow withdrawals in this currency.

Plus the errors common to all signed endpoints.