List all deposits
List the money that has arrived across all of your virtual accounts, newest first. This feed is available in production.
The rows arrive in deposits. Alongside them, total reports how many deposits match your filters and total_pages how many pages that is.
curl --request GET \
--url https://api.balampay.com/v1/virtual-accounts/deposits \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.balampay.com/v1/virtual-accounts/deposits"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.balampay.com/v1/virtual-accounts/deposits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.balampay.com/v1/virtual-accounts/deposits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.balampay.com/v1/virtual-accounts/deposits"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.balampay.com/v1/virtual-accounts/deposits")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.balampay.com/v1/virtual-accounts/deposits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"deposits": [
{
"id": "5c6d7e80-9fa0-4b1c-8d2e-3f4a5b6c7d8e",
"virtual_account_id": "11111111-2222-3333-4444-555555555555",
"amount": "100.00000000",
"currency": "USDT",
"status": "COMPLETED",
"sender": {
"name": null,
"account_number": null,
"address": "TD5gsCwxykWsLN9aPrq2TAfNjByuZKYp4E"
},
"recipient": {
"name": "Alice Smith",
"company_name": "Northwind Trading LLC",
"country": "MEX"
},
"payment_rail": "stablecoin",
"settlement_tx_hash": null,
"source": {
"name": null,
"account_number": null,
"address": "TD5gsCwxykWsLN9aPrq2TAfNjByuZKYp4E",
"payment_rail": "stablecoin",
"reference_number": null,
"imad": null,
"omad": null,
"trace_number": null,
"network": "tron",
"tx_hash": "84ae83cab526664b44ee51b6f811ab04b2525de2010f8a9c026020a4df486f89"
},
"fees": {
"base_fees": {
"fixed_fee": "3.10",
"percentage_fee": "0.08",
"fx_markup": "0.06"
},
"client_markup": {
"fixed_fee": "0.00",
"percentage_fee": "0.00",
"fx_markup": "0.00"
},
"total_fees": "3.24"
},
"net_amount": "96.76",
"net_currency": "USD",
"fee_total": "3.24",
"fee_currency": "USD",
"markup_total": "0.00",
"quotation": {
"quote_id": "9d8c7b60-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
"quote_expires_at": "2026-10-13 03:20:46.859+00",
"source": {
"amount": 10000,
"currency": "USD",
"precision": 2
},
"recipient": {
"amount": 9676,
"currency": "USD",
"precision": 2
},
"pricing_context": {
"tier": "tier_1",
"starting_tier": "tier_1",
"intro_period_active": false,
"transactional_waived": false,
"month_cumulative": 0,
"month_cumulative_currency": "USDT",
"from_held_balance": false
},
"conversion": {
"pair": "USDT/USD",
"rate": "1.000000",
"source_amount": 9676,
"source_currency": "USD",
"target_amount": 9676,
"target_currency": "USD",
"rate_source": "kraken",
"market_rate": "1.000000",
"clamp": "passthrough",
"locked_at": "2026-10-13 03:20:46.867+00",
"ttl_seconds": 900
},
"fees": [
{
"code": "inbound",
"status": "active",
"version": "v1",
"deprecated_at": null,
"charged_by": "kira",
"amount": 8,
"currency": "USD",
"precision": 2,
"kind": "percentage",
"calculation_method": "percentage",
"rate_bps": 8,
"basis_amount": 10000,
"basis_currency": "USD"
},
{
"code": "conversion_off_ramp",
"status": "active",
"version": "v1",
"deprecated_at": null,
"charged_by": "kira",
"amount": 6,
"currency": "USD",
"precision": 2,
"kind": "percentage",
"calculation_method": "percentage",
"rate_bps": 6,
"basis_amount": 10000,
"basis_currency": "USD"
},
{
"code": "tron_inbound",
"status": "active",
"version": "v1",
"deprecated_at": null,
"charged_by": "kira",
"amount": 310,
"currency": "USD",
"precision": 2,
"kind": "fixed"
}
],
"totals": {
"kira_revenue_total": 324,
"client_markup_total": 0,
"fee_total": 324,
"source_net_amount": 9676,
"currency": "USD",
"precision": 2
}
},
"depeg_cost": "0.00",
"events": [
{
"stage": "received",
"created_at": "2026-10-13T03:20:46.829Z"
},
{
"stage": "under_review",
"created_at": "2026-10-13T03:20:47.009Z"
},
{
"stage": "approved",
"created_at": "2026-10-13T03:20:47.723Z"
},
{
"stage": "in_transit",
"created_at": "2026-10-13T03:20:47.794Z"
},
{
"stage": "credited",
"created_at": "2026-10-13T03:20:55.398Z"
}
],
"created_at": "2026-10-13T03:20:46.829Z",
"updated_at": "2026-10-13T03:20:55.393Z",
"metadata": {}
},
{
"id": "77777777-8888-9999-aaaa-bbbbbbbbbbbb",
"virtual_account_id": "11111111-2222-3333-4444-555555555555",
"amount": "1000.00",
"currency": "USD",
"status": "COMPLETED",
"sender": {
"name": "Acme Corp",
"account_number": "****6789",
"address": "123 Market St, San Francisco, CA"
},
"recipient": {
"name": "Alice Smith",
"company_name": "Northwind Trading LLC",
"country": "USA"
},
"payment_rail": "wire",
"settlement_tx_hash": null,
"source": {
"name": "Acme Corp",
"account_number": "****6789",
"address": "123 Market St, San Francisco, CA",
"payment_rail": "wire",
"reference_number": "REF-998877",
"imad": "20260901MMQFMP0100001",
"omad": null,
"trace_number": null
},
"fees": {
"base_fees": {
"fixed_fee": "2.50",
"percentage_fee": "0.00",
"fx_markup": "0.00"
},
"client_markup": {
"fixed_fee": "1.00",
"percentage_fee": "0.00",
"fx_markup": "0.00"
},
"total_fees": "3.50"
},
"net_amount": "996.50",
"net_currency": "USD",
"fee_total": "3.50",
"fee_currency": "USD",
"markup_total": "1.00",
"events": [],
"settlement": null,
"created_at": "2026-09-01T18:05:32.000Z",
"updated_at": "2026-09-01T18:07:10.000Z",
"metadata": {
"invoice_id": "INV-2026-0042"
}
}
],
"total": 43,
"page": 1,
"limit": 10,
"total_pages": 5
}{
"code": "validation_error",
"message": "Invalid query parameters",
"errors": [
{
"field": "limit",
"message": "Number must be less than or equal to 100"
}
]
}{
"code": "invalid_request",
"message": "The request could not be matched to a valid route, or was malformed. Verify the path and HTTP method against the API reference. This is a routing or request error, not a credentials or signature problem."
}Authorizations
The data.access_token value from Get access token.
Headers
Version applied to this request. It wins over your account's pinned version — see Versioning.
"2026-06-01"
Query Parameters
Which page to return, counting from 1. This feed pages by number, not by offset.
x >= 1How many deposits to return. Between 1 and 100, and 10 when you omit it.
A value outside that range is rejected with a 400.
1 <= x <= 100Filter by deposit status.
Available options: PENDING, COMPLETED, FAILED, REFUNDED, KYT_PENDING, KYT_REJECTED. See Virtual account values for what each one means.
Return only the deposits into this one account.
Return only deposits from this moment on, included. Send a full ISO 8601 timestamp or just a date as YYYY-MM-DD.
Return only deposits up to this moment, included. Send a full ISO 8601 timestamp or just a date as YYYY-MM-DD, which covers that whole day.
Return only the deposit whose ID or tracking reference is this one: the IMAD of a wire, the trace number of an ACH transfer, or the bank's reference number, matched whole and whatever its case. Up to 255 characters.
255Return only the deposits of this amount, compared as a number: 26.41 finds a deposit of 26.41000000. A plain decimal such as 26.41, with no thousands separator. Greater than zero.
^(?!0+(\.0+)?$)\d{1,18}(\.\d{1,8})?$"26.41"
curl --request GET \
--url https://api.balampay.com/v1/virtual-accounts/deposits \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.balampay.com/v1/virtual-accounts/deposits"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.balampay.com/v1/virtual-accounts/deposits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.balampay.com/v1/virtual-accounts/deposits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.balampay.com/v1/virtual-accounts/deposits"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.balampay.com/v1/virtual-accounts/deposits")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.balampay.com/v1/virtual-accounts/deposits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"deposits": [
{
"id": "5c6d7e80-9fa0-4b1c-8d2e-3f4a5b6c7d8e",
"virtual_account_id": "11111111-2222-3333-4444-555555555555",
"amount": "100.00000000",
"currency": "USDT",
"status": "COMPLETED",
"sender": {
"name": null,
"account_number": null,
"address": "TD5gsCwxykWsLN9aPrq2TAfNjByuZKYp4E"
},
"recipient": {
"name": "Alice Smith",
"company_name": "Northwind Trading LLC",
"country": "MEX"
},
"payment_rail": "stablecoin",
"settlement_tx_hash": null,
"source": {
"name": null,
"account_number": null,
"address": "TD5gsCwxykWsLN9aPrq2TAfNjByuZKYp4E",
"payment_rail": "stablecoin",
"reference_number": null,
"imad": null,
"omad": null,
"trace_number": null,
"network": "tron",
"tx_hash": "84ae83cab526664b44ee51b6f811ab04b2525de2010f8a9c026020a4df486f89"
},
"fees": {
"base_fees": {
"fixed_fee": "3.10",
"percentage_fee": "0.08",
"fx_markup": "0.06"
},
"client_markup": {
"fixed_fee": "0.00",
"percentage_fee": "0.00",
"fx_markup": "0.00"
},
"total_fees": "3.24"
},
"net_amount": "96.76",
"net_currency": "USD",
"fee_total": "3.24",
"fee_currency": "USD",
"markup_total": "0.00",
"quotation": {
"quote_id": "9d8c7b60-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
"quote_expires_at": "2026-10-13 03:20:46.859+00",
"source": {
"amount": 10000,
"currency": "USD",
"precision": 2
},
"recipient": {
"amount": 9676,
"currency": "USD",
"precision": 2
},
"pricing_context": {
"tier": "tier_1",
"starting_tier": "tier_1",
"intro_period_active": false,
"transactional_waived": false,
"month_cumulative": 0,
"month_cumulative_currency": "USDT",
"from_held_balance": false
},
"conversion": {
"pair": "USDT/USD",
"rate": "1.000000",
"source_amount": 9676,
"source_currency": "USD",
"target_amount": 9676,
"target_currency": "USD",
"rate_source": "kraken",
"market_rate": "1.000000",
"clamp": "passthrough",
"locked_at": "2026-10-13 03:20:46.867+00",
"ttl_seconds": 900
},
"fees": [
{
"code": "inbound",
"status": "active",
"version": "v1",
"deprecated_at": null,
"charged_by": "kira",
"amount": 8,
"currency": "USD",
"precision": 2,
"kind": "percentage",
"calculation_method": "percentage",
"rate_bps": 8,
"basis_amount": 10000,
"basis_currency": "USD"
},
{
"code": "conversion_off_ramp",
"status": "active",
"version": "v1",
"deprecated_at": null,
"charged_by": "kira",
"amount": 6,
"currency": "USD",
"precision": 2,
"kind": "percentage",
"calculation_method": "percentage",
"rate_bps": 6,
"basis_amount": 10000,
"basis_currency": "USD"
},
{
"code": "tron_inbound",
"status": "active",
"version": "v1",
"deprecated_at": null,
"charged_by": "kira",
"amount": 310,
"currency": "USD",
"precision": 2,
"kind": "fixed"
}
],
"totals": {
"kira_revenue_total": 324,
"client_markup_total": 0,
"fee_total": 324,
"source_net_amount": 9676,
"currency": "USD",
"precision": 2
}
},
"depeg_cost": "0.00",
"events": [
{
"stage": "received",
"created_at": "2026-10-13T03:20:46.829Z"
},
{
"stage": "under_review",
"created_at": "2026-10-13T03:20:47.009Z"
},
{
"stage": "approved",
"created_at": "2026-10-13T03:20:47.723Z"
},
{
"stage": "in_transit",
"created_at": "2026-10-13T03:20:47.794Z"
},
{
"stage": "credited",
"created_at": "2026-10-13T03:20:55.398Z"
}
],
"created_at": "2026-10-13T03:20:46.829Z",
"updated_at": "2026-10-13T03:20:55.393Z",
"metadata": {}
},
{
"id": "77777777-8888-9999-aaaa-bbbbbbbbbbbb",
"virtual_account_id": "11111111-2222-3333-4444-555555555555",
"amount": "1000.00",
"currency": "USD",
"status": "COMPLETED",
"sender": {
"name": "Acme Corp",
"account_number": "****6789",
"address": "123 Market St, San Francisco, CA"
},
"recipient": {
"name": "Alice Smith",
"company_name": "Northwind Trading LLC",
"country": "USA"
},
"payment_rail": "wire",
"settlement_tx_hash": null,
"source": {
"name": "Acme Corp",
"account_number": "****6789",
"address": "123 Market St, San Francisco, CA",
"payment_rail": "wire",
"reference_number": "REF-998877",
"imad": "20260901MMQFMP0100001",
"omad": null,
"trace_number": null
},
"fees": {
"base_fees": {
"fixed_fee": "2.50",
"percentage_fee": "0.00",
"fx_markup": "0.00"
},
"client_markup": {
"fixed_fee": "1.00",
"percentage_fee": "0.00",
"fx_markup": "0.00"
},
"total_fees": "3.50"
},
"net_amount": "996.50",
"net_currency": "USD",
"fee_total": "3.50",
"fee_currency": "USD",
"markup_total": "1.00",
"events": [],
"settlement": null,
"created_at": "2026-09-01T18:05:32.000Z",
"updated_at": "2026-09-01T18:07:10.000Z",
"metadata": {
"invoice_id": "INV-2026-0042"
}
}
],
"total": 43,
"page": 1,
"limit": 10,
"total_pages": 5
}{
"code": "validation_error",
"message": "Invalid query parameters",
"errors": [
{
"field": "limit",
"message": "Number must be less than or equal to 100"
}
]
}{
"code": "invalid_request",
"message": "The request could not be matched to a valid route, or was malformed. Verify the path and HTTP method against the API reference. This is a routing or request error, not a credentials or signature problem."
}