Get a virtual account
Retrieve a single virtual account by its UUID, including its current status and bank deposit details. The account must belong to you. On the 2026-04-14 pin, bank details are projected as flat top-level fields (account_number, routing_number, bank_name, bank_address, account_holder_name); the list endpoint returns provider and currency as null, so fetch a VA by ID when you need those fields.
Authorizations
Access token from POST /auth (the data.access_token value).
API key issued by Kira. Required on every request, including /auth.
Headers
Optional. The date-versioned API version to apply for this request (e.g. 2026-04-14). When sent it always wins, even over your pinned account default. When omitted, the API uses your account's pinned version if set, otherwise a baseline default.
"2026-04-14"
Path Parameters
Virtual account UUID.
Response
Success.
A virtual account as returned by the VA read endpoints (GET /v1/virtual-accounts, GET /v1/virtual-accounts/{virtual_account_id}). On the 2026-04-14 pin, status is the KYB-mapped value (see the enum) and bank details are projected as flat top-level fields. The list view returns a thinner projection: markup is present only when fetching a single VA by ID, and provider/currency come back null in the list. All fields beyond the required set may be absent or null.
Virtual account UUID.
UUID of the user that owns this virtual account.
KYB-mapped account status (the response shape on the 2026-04-14 pin). Internally active/activating surface as approved, pending as rfi, and failed as declined; deactivated passes through. Note the status query filter on the list endpoint uses the raw values (pending, activating, active, failed, deactivated) instead.
approved, rfi, declined, deactivated Virtual account type.
US_BANK Funding mode. Fixed at creation.
fiat, crypto ISO 8601 timestamp.
ISO 8601 timestamp.
Selected bank/provider rail (e.g. slovak_savings_bank in sandbox).
Crypto payout destination (currency, network, address). null for fiat-mode accounts.
Provider deposit instructions the flat bank fields are projected from.
Inbound/outbound payment methods supported by this account.
Alias of payment_methods (same shape).
Flat bank detail projected from source_deposit_instructions.
Flat bank detail. null (or the ACT-only "PENDING-ACT-ACCOUNT" sentinel) until the account is provisioned.
Flat bank detail projected from source_deposit_instructions.
Flat bank detail projected from source_deposit_instructions.
Flat bank detail projected from source_deposit_instructions.
Flat bank detail projected from source_deposit_instructions.
Human-readable label set at creation.
Human-readable reason backing the current status (e.g. RFI details).
Markup configuration. Present only when fetching a single VA by ID — omitted from the list projection.
Customer-attached Stripe-style key/value metadata.