API reference
Cable TV
Check a smartcard, then renew DStv, GOtv or StarTimes.
POSThttps://uzobestgsm.com/api/v2/cable/
Header Authorization: Bearer YOUR_API_KEY. Try it free with your test key.
Check the smartcard first
Optional. Shows the customer's name. Nothing is charged.
Request
curl "https://uzobestgsm.com/api/v2/verify/smartcard/?provider=GOTV&smartcard=7012345678" -H "Authorization: Bearer YOUR_API_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). |
| providerrequired | The company's named ID, e.g. GOTV, DSTV or IKEJA. |
| packagerequired | The package's named ID, e.g. GOTV_JOLLI. Plan IDs list. |
| smartcardrequired | Smartcard or IUC number. |
Example
curl -X POST https://uzobestgsm.com/api/v2/cable/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"reference": "ORD10025", "provider": "GOTV", "package": "GOTV_JOLLI", "smartcard": "7012345678"}'
$ch = curl_init('https://uzobestgsm.com/api/v2/cable/');
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' => 'ORD10025',
'provider' => 'GOTV',
'package' => 'GOTV_JOLLI',
'smartcard' => '7012345678'
]),
]);
$answer = json_decode(curl_exec($ch), true);
const res = await fetch('https://uzobestgsm.com/api/v2/cable/', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({"reference": "ORD10025", "provider": "GOTV", "package": "GOTV_JOLLI", "smartcard": "7012345678"}),
});
const answer = await res.json();
import requests
answer = requests.post(
'https://uzobestgsm.com/api/v2/cable/',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={"reference": "ORD10025", "provider": "GOTV", "package": "GOTV_JOLLI", "smartcard": "7012345678"},
timeout=150,
).json()
The answer
Read data.status: successful, pending or failed (refunded).
Answer
{
"status": true,
"message": "Order successful.",
"data": {
"reference": "ORD10025",
"id": "Data8935fa7f7",
"service": "cable",
"status": "successful",
"message": "Order successful.",
"amount": "1000.00",
"balance_before": "5000.00",
"balance_after": "4000.00",
"account": "7012345678"
},
"request_id": "req_3f9a1c2b7d4e5f60"
}
Pending? Look it up. Refused? See Errors.
Using the Classic / MSORG address instead?
POST https://uzobestgsm.com/api/cablesub/, header Token YOUR_API_KEY, fields cablename, cableplan, smart_card_number.
Updated 2026-11-20. Questions? Contact support.

