Get a virtual account

GET

virtual-accounts

{virtual_account_id}

curl --request GET \
  --url https://api.balampay.com/v1/virtual-accounts/{virtual_account_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Api-Version: <x-api-version>' \
  --header 'x-api-key: <api-key>'

{
  "message": "<string>",
  "code": "<string>",
  "statusCode": 123,
  "error": "<string>",
  "timestamp": "<string>",
  "path": "<string>",
  "details": "<unknown>"
}

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

required

Example:

"2026-04-14"

Path Parameters

virtual_account_id

string<uuid>

required

Virtual account UUID.

Response

Success.

Get virtual account balanceReturns `200` with `available_balance` on an active VA (`400` while activating). **The sandbox balance is a FIXED provider value — `simulate-deposit` does NOT change it.** Do not use a balance delta to confirm a simulated deposit; use the simulate `201` response + the (hand-delivered) `virtual_account.deposit_funds_received` webhook.

⌘I

Get a virtual account

curl --request GET \
  --url https://api.balampay.com/v1/virtual-accounts/{virtual_account_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Api-Version: <x-api-version>' \
  --header 'x-api-key: <api-key>'

{
  "message": "<string>",
  "code": "<string>",
  "statusCode": 123,
  "error": "<string>",
  "timestamp": "<string>",
  "path": "<string>",
  "details": "<unknown>"
}