Getting Started

Quickstart

Connect your application to Buy Airtime and send airtime through a single API designed for reliable, retry-safe transactions.

1. Authenticate

Authenticate every protected API request with your customer bearer credential.

Read Authorization →

2. Protect retries

Attach a unique idempotency key to every intended airtime transaction so safe retries do not create duplicate orders.

Read Idempotency →

3. Send airtime

Submit the service, recipient account, amount, currency and your reference.

cURL

curl -X POST https://api.buyairtime.co.ke/v1/airtime \
  -H "Authorization: Bearer {{token}}" \
  -H "Idempotency-Key: {{unique-key}}" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "safaricom",
    "account": "0733000000",
    "amount": 10,
    "currency": "KES",
    "reference": "order-123"
  }'

Read Send airtime →

Transaction Status

Retrieve the current status of an airtime transaction by its reference.

GET

GET /v1/airtime/{reference}

Read Transaction Status →

Balance

Retrieve the available account balance used for API airtime transactions.

GET

GET /v1/balance

Read Balance →

Messaging

Messaging is reserved for a later phase of the API. The navigation is included now so the documentation structure can grow without breaking links.