Skip to main content
GET
Get virtual bank account details
Requires scope: manage:accounts — see Required scopes. Returns the virtual bank account, including its bank coordinates (IBAN/BIC for EUR, account and routing number for USD) and the referenceCode to quote on incoming transfers so settlement is matched to this account.

Authorizations

Headers

x-tenant-id
string<uuid>

Which tenant the request is scoped to, among those your token grants. Omit it when the token grants exactly one tenant; it is required when the token grants more than one. A supplied value must exactly match a tenant the token grants.

Absent when required, blank, malformed, or naming a tenant the token does not grant — each gets the same generic 403 forbidden, which reveals neither whether a tenant exists nor which ones you may use. Send the header once: a repeated header is rejected the same way.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Path Parameters

accountId
string<uuid>
required

Unique account identifier

virtualBankAccountId
string<uuid>
required

Unique virtual bank account identifier

Response

Virtual bank account details

success
boolean

Indicates whether the request was successful

result
object

Virtual bank account for receiving fiat payments that are auto-converted to crypto. EUR_SEPA accounts return iban/bic; USD_ACH accounts return accountNumber/routingNumber. Read depositRails for the complete instruction set per rail — the summary fields below always describe the primary rail.