Skip to main content
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.
If a virtual account is unavailable for a currency, the response degrades to an unavailable shape instead of full bank details: { "object": "virtual_account", "currency": "EUR", "status": "unavailable", "message": "..." }.

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).