List bank accounts

GET

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

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

Lists the bank accounts linked to the account for this currency, oldest first. Bank accounts belong to one account: the primary, or the sub-account selected with X-VALR-SUB-ACCOUNT-ID.

Parameters

Path Parameters

currency*

Fiat currency of the bank accounts, e.g. ZAR.

Type

string

Required

Example"ZAR"

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"

},

{

"id": "8f2a6d10-c3e4-4b7f-a915-2e7c0b9d4f68",

"bank": "Standard Bank",

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

"accountNumber": "10094857261",

"branchCode": "051001",

"accountType": "Current/Cheque",

"createdAt": "2026-09-30T13:05:12.774031Z",

"country": "ZA"

}

]

Samples

Errors

HTTP	Error	When
400	-11INVALID_REQUEST	The currency isn't recognised.
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.