API reference
Buy data
Send a data plan to a phone number. Paid from your wallet at your API price.
POSThttps://uzobestgsm.com/api/v2/data/
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). |
| planrequired | The named plan ID, e.g. MTN_SME_1GB_30DAYS (see Plan IDs). Plan IDs list. |
| ported_numberoptional | true if the number moved from another network. Default false. |
Example
curl -X POST https://uzobestgsm.com/api/v2/data/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"reference": "ORD10023", "network": "MTN", "phone": "08031234567", "plan": "MTN_SME_1GB_30DAYS"}'
$ch = curl_init('https://uzobestgsm.com/api/v2/data/');
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' => 'ORD10023',
'network' => 'MTN',
'phone' => '08031234567',
'plan' => 'MTN_SME_1GB_30DAYS'
]),
]);
$answer = json_decode(curl_exec($ch), true);
const res = await fetch('https://uzobestgsm.com/api/v2/data/', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({"reference": "ORD10023", "network": "MTN", "phone": "08031234567", "plan": "MTN_SME_1GB_30DAYS"}),
});
const answer = await res.json();
import requests
answer = requests.post(
'https://uzobestgsm.com/api/v2/data/',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={"reference": "ORD10023", "network": "MTN", "phone": "08031234567", "plan": "MTN_SME_1GB_30DAYS"},
timeout=150,
).json()
The answer
Read data.status: successful, pending or failed (refunded).
Answer
{
"status": true,
"message": "Order successful.",
"data": {
"reference": "ORD10023",
"id": "Data8935fa7f7",
"service": "data",
"status": "successful",
"message": "Order successful.",
"amount": "1000.00",
"balance_before": "5000.00",
"balance_after": "4000.00",
"phone": "08031234567",
"network": "MTN",
"plan": "MTN_SME_1GB_30DAYS"
},
"request_id": "req_3f9a1c2b7d4e5f60"
}
Pending? Look it up. Refused? See Errors.
Using the Classic / MSORG address instead?
POST https://uzobestgsm.com/api/data/, header Token YOUR_API_KEY, fields network, mobile_number, plan, Ported_number, customer_ref.
Updated 2026-11-20. Questions? Contact support.

