API reference

Buy airtime

Send airtime to a phone number on any network.

POSThttps://uzobestgsm.com/api/v2/airtime/

Header Authorization: Bearer YOUR_API_KEY. Try it free with your test key.

What to send

FieldWhat it is
referencerequiredYour own unique ID for this order (1 to 64 letters, digits, dot, dash or underscore).
networkrequiredMTN, GLO, AIRTEL or T2.
phonerequired11 digits, e.g. 08031234567 (+234 and 234 are accepted).
amountrequiredNaira.
typeoptionalVTU (the default).
ported_numberoptionaltrue if the number moved from another network. Default false.

Example

curl -X POST https://uzobestgsm.com/api/v2/airtime/ \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"reference": "ORD10024", "network": "MTN", "phone": "08031234567", "amount": 100}'

The answer

Read data.status: successful, pending or failed (refunded).

Answer
{ "status": true, "message": "Order successful.", "data": { "reference": "ORD10024", "id": "Data8935fa7f7", "service": "airtime", "status": "successful", "message": "Order successful.", "amount": "1000.00", "balance_before": "5000.00", "balance_after": "4000.00", "phone": "08031234567", "network": "MTN" }, "request_id": "req_3f9a1c2b7d4e5f60" }

Pending? Look it up. Refused? See Errors.

Using the Classic / MSORG address instead?
POST https://uzobestgsm.com/api/topup/, header Token YOUR_API_KEY, fields network, amount, mobile_number, airtime_type, Ported_number.

Updated 2026-11-20. Questions? Contact support.