Get Balance

Returns the real-time balance for an account. Amounts are expressed in the account’s currency as minor units (fils for AED, cents for USD/EUR/GBP).

GET/v1/accounts/{id}/balance

Request

curl https://api.vaultspay.ae/v1/accounts/acc_01HX7.../balance \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

Response

200 OK

{
  "object": "balance",
  "account_id": "acc_01HX71YM6FJ3A8W7T5K6NRB2DN",
  "currency": "AED",
  "available": 125000,
  "pending": 5000,
  "reserved": 0,
  "total": 130000,
  "as_of": "2026-04-24T14:52:03.182Z"
}

Field definitions

Field	Meaning
`available`	Spendable now (settled + available for card transactions).
`pending`	Inbound credits not yet cleared.
`reserved`	Funds held for authorisations that haven’t settled.
`total`	`available + pending + reserved`.

List Accounts List Transactions