List virtual account deposits
List the deposits received by a single virtual account, newest first. The virtual account must belong to you.
The response is a bare JSON array of deposit objects — there is no envelope and no pagination metadata. Page through results with limit/offset and infer “more pages” from whether a full page was returned.
Query parameters
limit— page size, clamped to1–100(out-of-range values are clamped, never rejected); defaults to10.offset— number of deposits to skip, clamped to0or greater; defaults to0.
Each deposit carries status (PENDING, COMPLETED, FAILED, REFUNDED, KYT_PENDING, KYT_REJECTED), the amount/currency, a fees breakdown with net_amount/net_currency, and counterparty info. Prefer the unified source object (it carries rail-specific tracking ids such as imad/omad for wires and trace_number for ACH) over the legacy sender. All money values are decimal strings.
Example response (200):
[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"virtual_account_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"amount": "1000.00",
"currency": "USD",
"status": "COMPLETED",
"sender": {
"name": "Acme Corp",
"account_number": "****7890",
"address": "123 Market St, San Francisco, CA"
},
"recipient": {
"name": "Jane Doe",
"company_name": "Doe Holdings LLC",
"country": "US"
},
"payment_rail": "WIRE",
"settlement_tx_hash": null,
"source": {
"name": "Acme Corp",
"account_number": "****7890",
"address": "123 Market St, San Francisco, CA",
"payment_rail": "WIRE",
"reference_number": null,
"imad": "20260625MMQFMP3K000123",
"omad": "20260625L1B7HU5R000456",
"trace_number": null
},
"fees": {
"base_fees": {
"fixed_fee": "1.50",
"percentage_fee": "2.00",
"fx_markup": "0"
},
"client_markup": {
"fixed_fee": "0.00",
"percentage_fee": "1.00",
"fx_markup": "0"
},
"total_fees": "4.50"
},
"net_amount": "995.50",
"net_currency": "USD",
"created_at": "2026-06-20T14:32:00.000Z",
"updated_at": "2026-06-20T14:35:10.000Z",
"metadata": {
"invoice_id": "INV-2026-0042"
}
}
]
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.
Query Parameters
Page size. Out-of-range values are clamped to 1-100 (never rejected); defaults to 10.
Number of deposits to skip. Negative values are clamped to 0; defaults to 0.
Response
Success.
Deposit UUID.
UUID of the virtual account that received this deposit.
Gross deposit amount (decimal string).
Deposit currency.
Deposit status (UPPERCASE).
PENDING, COMPLETED, FAILED, REFUNDED, KYT_PENDING, KYT_REJECTED ISO 8601 timestamp.
ISO 8601 timestamp.
Legacy counterparty shape (name, account_number, address only). Prefer source.
Recipient (the VA owner) summary.
Legacy top-level rail; mirrored on source.payment_rail.
On-chain settlement transaction hash, when applicable.
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.
Deposit fee breakdown. total_fees equals the per-component sum of base_fees + client_markup.
Amount after fees (decimal string).
Currency of net_amount (3-letter ISO code).
Customer-attached metadata, snapshotted from the parent VA at deposit creation.