Balance Check API

Authentication

Every request requires your API key in the headers.

Content-Typeapplication/json
Header Namex-api-key
AlternativeAuthorization: Bearer KEY

Check Balance

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

GEThttps://fastapesa.com/api/v1/balance
cURL Example
curl -X GET https://fastapesa.com/api/v1/balance \
  -H "x-api-key: YOUR_API_KEY"

JSON Response

{
  "type": "success",
  "message": "Balance retrieved successfully",
  "data": {
    "currencies_count": 1,
    "balances": {
      "TZS": {
        "currency": "TZS",
        "balance": "26.00"
      }
    },
    "timestamp": "2026-06-23T06:46:58.000Z"
  }
}