Airtime
Transaction Status
Check the current processing state of an airtime transaction using the reference returned by the order flow.
GET
/v1/airtime/{reference}Request
Replace {reference} with the transaction reference you supplied when creating the airtime order.
cURL
curl -X GET https://api.buyairtime.co.ke/v1/airtime/order-123 \
-H "Authorization: Bearer {{token}}"Response
The public transaction response uses the same core fields returned by the airtime order request.
JSON
{
"id": "BAI_ABC123",
"reference": "order-123",
"status": 0,
"message": "Pending"
}| Field | Type | Description |
|---|---|---|
| id | string | Buy Airtime transaction identifier. |
| reference | string | Your transaction reference. |
| status | number | Provider transaction status code. |
| message | string | Human-readable transaction status message. |
Pending is not failure. An accepted airtime order can remain pending while the upstream provider completes processing. Use this endpoint or your configured webhook flow to observe the final state.
Common errors
| HTTP | Meaning |
|---|---|
| 401 | Missing or invalid authentication. |
| 404 | The transaction reference does not exist. |
| 502 | The upstream provider could not be reached or returned an invalid response. |