Skip to main content
GET
List virtual account deposits
Stable since 2025-01-01 — unchanged in 2026-04-14.

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-04-14"

Path Parameters

virtual_account_id
string<uuid>
required

Virtual account UUID.

Query Parameters

limit
integer
default:10

Page size. Out-of-range values are clamped to 1-100 (never rejected); defaults to 10.

offset
integer
default:0

Number of deposits to skip. Negative values are clamped to 0; defaults to 0.

Response

Success.

id
string<uuid>
required

Deposit UUID.

virtual_account_id
string<uuid>
required

UUID of the virtual account that received this deposit.

amount
string
required

Gross deposit amount (decimal string).

currency
string
required

Deposit currency.

status
enum<string>
required

Deposit status (UPPERCASE).

Available options:
PENDING,
COMPLETED,
FAILED,
REFUNDED,
KYT_PENDING,
KYT_REJECTED
created_at
string
required

ISO 8601 timestamp.

updated_at
string
required

ISO 8601 timestamp.

sender
object | null

Legacy counterparty shape (name, account_number, address only). Prefer source.

recipient
object | null

Recipient (the VA owner) summary.

payment_rail
string | null

Legacy top-level rail; mirrored on source.payment_rail.

settlement_tx_hash
string | null

On-chain settlement transaction hash, when applicable.

source
object | null

Unified counterparty / wire-tracking shape. Rail-specific identifiers are present only when relevant: ACT wires populate reference_number; Fedwire wires populate imad/omad; ACH populates trace_number.

fees
object

Deposit fee breakdown. total_fees equals the per-component sum of base_fees + client_markup.

net_amount
string

Amount after fees (decimal string).

net_currency
string

Currency of net_amount (3-letter ISO code).

metadata
object

Customer-attached metadata, snapshotted from the parent VA at deposit creation.