Get balance

Read a wallet's available balance, in kobo. Available equals ledger - there are no holds.

GET/v1/wallets/:id/balance
wallet

Returns the wallet's available balance. Available equals ledger: there are no holds. The wallet must be at tier1; reading the balance of a none wallet returns 403 (WALLET_KYC_REQUIRED).

Try it, for realGET /wallets/:id/balancescope: wallet

Test keys only. Never paste a live key. Your key is stored only in this browser (localStorage) and sent only to the same-origin playground proxy.

›Equivalent request (curl / TypeScript)
curl
curl -X GET https://sandbox.api.acute.network/v1/wallets/acuinf483920175566wlt/balance \
  -H "Authorization: Bearer acuinf_test_…"
TypeScript
const res = await fetch("https://sandbox.api.acute.network/v1/wallets/acuinf483920175566wlt/balance", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.ACUTE_TEST_KEY}`,
  },
});
const { data, meta } = await res.json();

# read a wallet balance
curl https://sandbox.api.acute.network/v1/wallets/acuinf483920175566wlt/balance \
  -H "Authorization: Bearer acuinf_test_…"
{
  "success": true,
  "statusCode": 200,
  "data": {
    "walletId": "acuinf483920175566wlt",
    "balance": 150000,
    "currency": "NGN"
  },
  "meta": { "requestId": "req_4f9c2a7e1b0d8c3a5e6f10a2" }
}

Read it, don't cache it

Balances change the moment money moves. Read the balance when you need it, or react to wallet webhooks; don't cache it client-side.

idstringpathrequired

The wallet reference.

WalletBalanceData.

walletIdstringrequired

The wallet reference.

balancenumber (kobo)required

Available balance in kobo. 150000 is ₦1,500.00.

currencystringrequired

The currency (NGN).