Virtual Accounts
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.
GET
/
v1
/
virtual-accounts
/
deposits
List all deposits
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.
Example:
"2026-04-14"
Query Parameters
Filter by deposit status.
Available options: PENDING, COMPLETED, FAILED, REFUNDED, KYT_PENDING, KYT_REJECTED. See Virtual account values for what each one means.
⌘I
List all deposits
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."
}