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
| Field | What it is |
|---|---|
| referencerequired | Your own unique ID for this order (1 to 64 letters, digits, dot, dash or underscore). |
| networkrequired | MTN, GLO, AIRTEL or T2. |
| phonerequired | 11 digits, e.g. 08031234567 (+234 and 234 are accepted). |
| amountrequired | Naira. |
| typeoptional | VTU (the default). |
| ported_numberoptional | true 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}'
$ch = curl_init('https://uzobestgsm.com/api/v2/airtime/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 150,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'ORD10024',
'network' => 'MTN',
'phone' => '08031234567',
'amount' => 100
]),
]);
$answer = json_decode(curl_exec($ch), true);
const res = await fetch('https://uzobestgsm.com/api/v2/airtime/', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({"reference": "ORD10024", "network": "MTN", "phone": "08031234567", "amount": 100}),
});
const answer = await res.json();
import requests
answer = requests.post(
'https://uzobestgsm.com/api/v2/airtime/',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={"reference": "ORD10024", "network": "MTN", "phone": "08031234567", "amount": 100},
timeout=150,
).json()
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.

