POST
/api/v1/data
The Mobile Data API allows seamless procurement of SME, Corporate Gifting, Direct, and Gifting internet data bundles for MTN, Airtel, Glo, and 9mobile.
📶 High-Speed Automated Data Top-Up
Dynamic Plan Lookup: Query active data bundle codes dynamically with the
Instant Delivery: Bundles are provisioned directly to the recipient SIM within 1–3 seconds with transaction status logs.
/data-variations endpoint.
Instant Delivery: Bundles are provisioned directly to the recipient SIM within 1–3 seconds with transaction status logs.
GET
/api/v1/data-variations
Retrieve all active data plans or filter by a specific network.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
network |
string | Optional | Filter by network code: mtn-data, airtel-data, glo-data, etisalat-data. |
Sample Plans Response
{
"status": "success",
"network": "mtn-data",
"count": 4,
"data": [
{
"service_name": "MTN Data",
"service_id": "mtn-data",
"variation_code": "mtn-500mb-30days",
"name": "MTN 500MB SME (30 Days)",
"variation_amount": "150.00",
"fixedPrice": "Yes",
"status": "enabled"
},
{
"service_name": "MTN Data",
"service_id": "mtn-data",
"variation_code": "mtn-1gb-30days",
"name": "MTN 1GB SME (30 Days)",
"variation_amount": "290.00",
"fixedPrice": "Yes",
"status": "enabled"
},
{
"service_name": "MTN Data",
"service_id": "mtn-data",
"variation_code": "mtn-2gb-30days",
"name": "MTN 2GB SME (30 Days)",
"variation_amount": "580.00",
"fixedPrice": "Yes",
"status": "enabled"
},
{
"service_name": "MTN Data",
"service_id": "mtn-data",
"variation_code": "mtn-5gb-30days",
"name": "MTN 5GB SME (30 Days)",
"variation_amount": "1450.00",
"fixedPrice": "Yes",
"status": "enabled"
}
]
}
Purchase Data Bundle Endpoint (POST)
| Parameter | Type | Required | Description & Example |
|---|---|---|---|
network |
string | Required | Network code: mtn-data, airtel-data, glo-data, etisalat-data. |
mobileno |
string | Required | Recipient's 11-digit mobile phone number (e.g., 08061234567). |
bundle |
string | Required | The plan variation code (e.g., mtn-1gb-30days, airtel-2gb-30days). |
request_id |
string | Optional | Unique merchant client reference for tracking. |
Integration Code Examples
curl -X POST "https://tente.com.ng/api/v1/data" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"network": "mtn-data",
"mobileno": "08061234567",
"bundle": "mtn-1gb-30days",
"request_id": "REQ_DAT_559102"
}'
Sample 200 OK Success Response
{
"status": "success",
"message": "Data bundle purchase for MTN 1GB SME (30 Days) to 08061234567 was successful.",
"data": {
"transaction_ref": "DAT202608311422108B7A",
"request_id": "REQ_DAT_559102",
"network": "mtn-data",
"network_name": "Mtn",
"bundle": "mtn-1gb-30days",
"plan_name": "MTN 1GB SME (30 Days)",
"amount": 290.00,
"phone": "08061234567",
"type": "Data Purchase",
"commission_rate": "1.5%",
"commission_earned": 4.35,
"new_balance": 47210.00,
"status": "completed",
"created_at": "2026-08-31T14:22:10+01:00"
}
}
Error Responses
422 Plan Not Found
{
"status": "error",
"message": "Selected data plan is invalid or currently unavailable."
}
402 Insufficient Balance
{
"status": "error",
"message": "Insufficient wallet balance."
}