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

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).
planrequiredThe named plan ID, e.g. MTN_SME_1GB_30DAYS (see Plan IDs). Plan IDs list.
ported_numberoptionaltrue 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"}'

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.