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
"2026-04-14"
Path Parameters
Virtual account UUID.
Response
Success.