Skip to main content
GET
Get a virtual account
Stable since 2026-05-28 — unchanged in 2026-06-01.

Authorizations

Authorization
string
header
required

Access token from POST /auth (the data.access_token value).

x-api-key
string
header
required

API key issued by Kira. Required on every request, including /auth.

Headers

X-Api-Version
string

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.

Example:

"2026-06-01"

Path Parameters

virtual_account_id
string<uuid>
required

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-06-01 pin, status is the raw internal 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.

id
string<uuid>
required

Virtual account UUID.

user_id
string<uuid>
required

UUID of the user that owns this virtual account.

status
enum<string>
required

Raw internal account status. active = ready to receive deposits; activating = provisioning; pending = awaiting KYC; failed = creation failed; deactivated = closed. Poll until active before use. On the 2026-06-01 pin the raw enum is returned (the KYB mapping applied on 2026-04-14 was reverted at 2026-05-28).

Available options:
pending,
activating,
active,
failed,
deactivated
type
enum<string>
required

Virtual account type.

Available options:
US_BANK
mode
enum<string>
required

Funding mode. Fixed at creation.

Available options:
fiat,
crypto
created_at
string
required

ISO 8601 timestamp.

updated_at
string
required

ISO 8601 timestamp.

bank
string | null

Selected bank/provider rail (e.g. slovak_savings_bank in sandbox).

destination
object | null

Crypto payout destination (currency, network, address). null for fiat-mode accounts.

source_deposit_instructions
object | null

Provider deposit instructions the flat bank fields are projected from.

payment_methods
object | null

Inbound/outbound payment methods supported by this account.

methods
object | null

Alias of payment_methods (same shape).

account_holder_name
string | null

Flat bank detail projected from source_deposit_instructions.

account_number
string | null

Flat bank detail. null (or the ACT-only "PENDING-ACT-ACCOUNT" sentinel) until the account is provisioned.

routing_number
string | null

Flat bank detail projected from source_deposit_instructions.

bank_name
string | null

Flat bank detail projected from source_deposit_instructions.

bank_address
string | null

Flat bank detail projected from source_deposit_instructions.

account_holder_address
string | null

Flat bank detail projected from source_deposit_instructions.

description
string

Human-readable label set at creation.

status_reason
string

Human-readable reason backing the current status (e.g. RFI details).

markup
object

Markup configuration. Present only when fetching a single VA by ID — omitted from the list projection.

metadata
object

Customer-attached Stripe-style key/value metadata.