Get Virtual Account
Virtual Accounts
Get Virtual Account
Fetch a single virtual account with its readiness status, bank details, and balances
GET
Get Virtual Account
Fetches a single virtual account with its current readiness status, bank-details payload, and balances. No request body. Use this endpoint as the source of truth after Create Virtual Account returns
pending.
Path Parameters
string
required
Virtual account id (
va_…).Response
string
Virtual account id (
va_…).string
Always
virtual_account.string
Owning account id (
acct_…).string
Currency of the virtual account (ISO 4217).
string
pending, active, revoked (disabled), or unavailable.string | null
Account holder name on the virtual account.
string | null
Account holder address.
string | null
Name of the bank holding the virtual account.
string | null
Address of the holding bank.
string | null
Display name of the account.
string | null
Virtual bank account number (VBAN). Null while
status = pending or when not supported by the rail.string | null
IBAN, where the currency/rail supports it. Null while
status = pending or when not supported by the rail.string | null
SWIFT/BIC of the holding bank.
string | null
US ABA routing number (ACH / Fedwire).
string | null
UK sort code (Faster Payments).
string | null
Intermediary (correspondent) bank name, if applicable.
string | null
Intermediary bank SWIFT/BIC, if applicable.
string[]
Payment rails the virtual account can receive on:
ach, fedwire, swift, sepa, spei, pix, faster_payments.decimal
Available balance, currency-formatted.
decimal
Inbound deposits received but not yet credited to the available balance.
decimal
Funds held for in-flight payments, including platform fees.
decimal
Total balance including pending deposits and held funds.
timestamp
Creation timestamp (ISO 8601, UTC).
timestamp | null
Last update timestamp (ISO 8601, UTC).