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 /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"
  }'
const response = await fetch("https://tente.com.ng/api/v1/data", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    network: "mtn-data",
    mobileno: "08061234567",
    bundle: "mtn-1gb-30days",
    request_id: "REQ_DAT_" + Date.now()
  })
});

const result = await response.json();
console.log(result);
<?php

$client = new \GuzzleHttp\Client();

$response = $client->post('https://tente.com.ng/api/v1/data', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_TOKEN',
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
    'json' => [
        'network'    => 'mtn-data',
        'mobileno'   => '08061234567',
        'bundle'     => 'mtn-1gb-30days',
        'request_id' => 'REQ_DAT_' . uniqid(),
    ]
]);

$data = json_decode($response->getBody(), true);
print_r($data);
import requests

url = "https://tente.com.ng/api/v1/data"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "network": "mtn-data",
    "mobileno": "08061234567",
    "bundle": "mtn-1gb-30days",
    "request_id": "REQ_DAT_123456"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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."
}