Airtime

Balance

Retrieve the available account balance used to fund API airtime transactions.

GET/v1/balance

Request

The balance endpoint requires the same authenticated bearer credential used by other protected API requests.

cURL

curl -X GET https://api.buyairtime.co.ke/v1/balance \
  -H "Authorization: Bearer {{token}}"

What the endpoint provides

Available funding balance

Use the endpoint to check the account balance available for API airtime transactions before initiating a larger batch of orders.

Implementation note

The balance endpoint is part of the public API documentation contract. Its exact provider-backed response schema should be treated as implementation-specific until the balance service is connected and its response contract is finalized.

Authentication

Send your bearer credential in the Authorization header. Do not expose provider credentials or upstream tokens to API consumers.

Header

Authorization: Bearer {{token}}