Data API

Provide data bundles and plans for all major telecommunication networks.

Get Data Plans

Retrieve the available data plans categorized by network and plan type (e.g., SME, Gifting, Corporate).

GET https://sureapi.ng/api/data_plans

Query Parameters

Parameter	Type	Required	Description

curl -X GET "https://sureapi.ng/api/data/data_plans" \
      -H "Authorization: Token YOUR_API_KEY" \
      -H "Content-Type: application/json"

<?php
    $url = 'https://sureapi.ng/api/data/data_plans';
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Token YOUR_API_KEY',
            'Content-Type: application/json',
        ]
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    print_r(json_decode($response, true));
    ?>

const response = await fetch('https://sureapi.ng/api/data/data_plans', {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    });
    const data = await response.json();
    console.log(data);

import requests

    url = "https://sureapi.ng/api/data/data_plans"
    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }
    response = requests.get(url, headers=headers)
    print(response.json())

Response

✓ 200 OK

{
[
  {
    "plan_id": 1,
    "day": "30",
    "type": "SME",
    "network": "MTN",
    "datasize": "500MB",
    "price": 450
  },
  {
    "plan_id": 2,
    "day": "30",
    "type": "SME",
    "network": "MTN",
    "datasize": "1GB",
    "price": 650
  }
]
    }

Purchase Data Bundle

Purchase a specific data plan for a recipient's phone number.

POST https://sureapi.ng/api/data

Request Body

Parameter	Type	Required	Description
phone	String	Yes	Recipient phone number.
plan	Integer	Yes	Plan ID retrieved from the `/data/plans` endpoint.
bypass	Boolean	Yes	Set to `true` to skip number validation (or use `Ported_number` instead).
request-id	String	Optional	Idempotency key.

curl -X POST "https://sureapi.ng/api/data" \
      -H "Authorization: Token YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "phone": "08012345678",
        "plan": 101,
        "bypass": true,
        "request-id": "data_123"
      }'

<?php
    $url = 'https://sureapi.ng/api/data';
    $payload = [
        'phone' => '08012345678',
        'plan' => 101,
        'bypass' => true,
        'request-id' => 'API_' . uniqid()
    ];
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($payload),
        CURLOPT_HTTPHEADER => [
            'Authorization: Token YOUR_API_KEY',
            'Content-Type: application/json',
        ]
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    print_r(json_decode($response, true));
    ?>

const response = await fetch('https://sureapi.ng/api/data', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        phone: '08012345678',
        plan: 101,
        bypass: true,
        'request-id': 'data_123'
      })
    });
    const data = await response.json();
    console.log(data);

import requests

    url = "https://sureapi.ng/api/data"
    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }
    payload = {
        "phone": "08012345678",
        "plan": 101,
        "bypass": True,
        "request-id": "data_123"
    }
    response = requests.post(url, json=payload, headers=headers)
    print(response.json())

Responses

✓ 200 OK

{
      "status": "success",
      "Status": "successful",
      "message": "Data Purchase Successful.",
      "response": "MTN 1GB SME (30 Days) sent to 08012345678",
      "api_response": "MTN 1GB SME (30 Days) sent to 08012345678",
      "request-id": "API_66bbd45c67b7b",
      "service": "data",
      "amount": "250",
      "old_balance": 5000,
      "new_balance": 4750
    }

← Previous

Cable TV API

Data PIN API