Like every V4 call, this endpoint family expects the three auth factors: a Bearer token (Authorization: Bearer …), a whitelisted source IP, and the per-request RSA signature headers (X-PP-Signature, X-PP-Nonce, X-PP-Timestamp). See Request Signing.
Returns the wallet balance derived from the double-entry ledger — not a cached column — as integer minor units.
Route parameters
| Param | Description |
|---|
accountNo | Your account number, e.g. ACC-1001. |
currency | ISO-4217 code — KES or USD. Currencies are siloed; there is no FX. |
Example
curl https://v4api.pokeapay.com/api/v4/accounts/ACC-1001/balance/KES \
-H "Authorization: Bearer $TOKEN" \
-H "X-PP-Signature: $SIG" -H "X-PP-Nonce: $NONCE" -H "X-PP-Timestamp: $TS"
Response — 200
{
"account_no": "ACC-1001",
"currency": "KES",
"balance_minor": 1254500
}
The V3 shape ({"balance":"12545.00"}, decimal string) remains available on the V3 compatibility adapter, derived from the same ledger.