Developed Documentation

Integrate our services into your application seamlessly.

Authentication User Details Data Plans Airtime List Purchase Data Purchase Airtime Transactions

Base URL

https://api.nata.ng/api

Authentication

Authenticate your requests by including your API key in the header.

Heading: apikey
            Value: YOUR_API_KEY

User Details

Retrieve your account details and current balance.

GET /user 
            {
                "id": 1,
                "name": "John Doe",
                "email": "[email protected]",
                "balance": 5000.00,
                ...
            }

Data Plans

Fetch available data plans. You can optionally filter by category.

GET /data-plans

Query Params:

  • category (optional): Filter plans (e.g., mtn_sme, glo, airtel_gifting).
            {
                "success": true,
                "data": [
                    {
                        "network": "mtn",
                        "name": "MTN",
                        "bundle": [
                            {
                                "plan_id": 50,
                                "category": "mtn_sme",
                                "price": 270.00,
                                "name": "1GB - 30 days"
                            }
                        ]
                    }
                ]
            }

Airtime List

Get the list of network IDs for airtime purchase.

GET /airtime 
            {
                "success": true,
                "data": [
                    {
                        "network": 15,
                        "name": "MTN airtime VTU"
                    },
                    ...
                ]
            }

Purchase Data

Initiate a data purchase transaction.

POST /buy-data
Parameter Type Description
plan_id Integer ID of the plan (get from /data-plans)
category String Plan category (get from /data-plans)
phone String 11 Digit Phone Number
reference String Unique Ref (6-12 chars). Must be unique to you. 
            {
                "status": "success",
                "message": "Data purchase initiated successfully."
            }

Purchase Airtime

Initiate an airtime purchase transaction.

POST /buy-airtime
Parameter Type Description
network Integer Network ID (15:MTN, 6:GLO, 1:AIRTEL, 2:9MOBILE)
amount Numeric Amount to purchase (Min: 50)
phone String 11 Digit Phone Number
reference String Unique Ref (6-12 chars). Must be unique. 
            {
                "status": "success",
                "message": "Airtime purchase initiated successfully"
            }

Transaction History

Fetch your latest 20 transactions.

GET /transactions