Wallet

Get the wallet

Your prepaid balance in kobo, what's held for checks still running, what's available, your alert level and this month's spend. Live money: the same whichever key asks.

GET/v1/wallet

Request

Authenticate with Authorization: Bearer <your key>.

Example

GET /v1/wallet

curl https://api.verath.io/v1/wallet \
  -H "Authorization: Bearer $VERATH_KEY"

200 OK

{
  "object": "wallet",
  "currency": "NGN",
  "balance_kobo": 5000000,
  "held_kobo": 15000,
  "available_kobo": 4985000,
  "low_balance_kobo": 1000000,
  "below_low_balance": false,
  "monthly_cap_kobo": null,
  "month_spend_kobo": 1230000,
  "updated_at": "2026-11-11T15:32:00.000Z"
}

Responses

Status	Meaning
200	The wallet (live money; the same whichever key asks).