Balance API | SpeedPesa

Authentication

Every request requires your API key in the headers.

Required Headers

Content-Type application/json

Header Name x-api-key

Alternative Authorization: Bearer KEY

Check Balance

Retrieve your current account balance in real-time. This endpoint returns all available currency balances in your SpeedPesa wallet.

GET https://speedpesa.com/api/v1/balance

cURL Example

curl -X GET https://speedpesa.com/api/v1/balance \ -H "x-api-key: YOUR_API_KEY"

JSON Response

Success Error

{ "type": "success", "message": "Balance retrieved successfully", "data": { "currencies_count": 1, "balances": { "TZS": { "currency": "TZS", "balance": "26.00" } }, "timestamp": "2026-06-23T09:46:58+03:00" } }

{ "type": "error", "message": "Invalid API key", "data": { "error_code": "unauthorized" } }