Documentation menu

API reference

Wallet

Your account's KES balance and transaction history. Read-only — top up from the portal.

GET/wallet/balance

Returns { balance: string, currency: string } — e.g. { "balance": "1250.00", "currency": "KES" }.

GET/wallet/transactions

Query: limit (integer, default 50, max 200), offset (integer, default 0). Returns array<Transaction>, newest first.

The Transaction object

FieldTypeDescription
uuidstringStable identifier.
directionstringdebit (charge) or credit (top-up / refund).
kindstringcall_charge · did_setup · did_monthly · tts · storage · topup · refund · adjustment.
amountstringKES amount.
balance_beforestringWallet balance before this entry.
created_atstringISO-8601 timestamp.