Power your app with Nigeria's reliable VTU & bill payment API. Data, airtime, cable TV, electricity, exam pins, data pins and recharge pins — all through one authenticated REST API with a single API key.
Every request is authenticated with your personal API key, which is shown in your dashboard under API Dashboard once your account is on the API tier.
# 1. Pull the full plan catalogue (all services + price plan IDs) GET https://your-domain.com/api/plans/ # 2. Buy data using a price plan ID POST https://your-domain.com/api/data/ { "network": "MTN", "phone": "08012345678", "data_plan": "644", "pin": "1234" }
Send these headers on every call:
Authorization: Token YOUR_API_KEY Content-Type: application/json
Replace your-domain.com with the domain you use to access G7DataPoint.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/user/ | Account details, wallet balance & API key |
| GET | /api/wallet/balance/ | Wallet balance |
| POST | /api/wallet/transfer/ | Wallet to wallet transfer |
| GET | /api/plans/ | All services plan catalogue — price plan IDs + prices |
| GET | /api/data/plans/ | Data plans (filter: ?network=MTN) |
| POST | /api/data/ | Buy data bundle |
| GET | /api/airtime/plans/ | Airtime rates per network |
| POST | /api/airtime/ | Buy airtime (VTU) |
| GET | /api/cabletv/plans/ | Cable packages (filter: ?provider=DSTV) |
| POST | /api/cabletv/ | Cable TV subscription |
| GET | /api/electricity/plans/ | Electricity discos |
| POST | /api/electricity/ | Pay electricity bill |
| GET | /api/exam/plans/ | Exam pin providers |
| POST | /api/exam/ | Buy exam pins |
| GET | /api/rechargepin/plans/ | Recharge card pin plans |
| POST | /api/rechargepin/ | Generate recharge pins |
| POST | /api/datapin/ | Generate data pins |
| GET | /api/transactions/ | Transaction history |
| GET | /api/notifications/ | Notifications |
| GET | /api/services/status/ | Service availability |
Each service keeps its own catalogue. The price plan ID is the identifier you pass to the buy endpoint for that service.
Field: price_plan_id → sent as data_plan. Includes network, type (SME/Gifting/Corporate), validity, cost price and your API price.
Field: price_plan_id → sent as cable_plan. Includes provider (DStv/GOtv/StarTimes), package name and validity.
Field: price_plan_id → sent as plan. Includes network, face value and your API price.
Field: price_plan_id. Includes network, pin value, type and validity.
Field: plan_id → sent as provider. Includes provider name and price.
Field: plan_id → sent as provider. Includes disco name and abbreviation.
{
"status": "success",
"currency": "NGN",
"account_type": "API",
"count": 4,
"services": ["networks", "airtime", "data", "cable", ...],
"data": {
"data": [
{
"price_plan_id": "644",
"network": "MTN",
"name": "500MB",
"type": "SME",
"validity_days": "7",
"userprice": "350",
"agentprice": "350",
"vendorprice": "335",
"my_price": 335
}
]
}
}
Create an account, upgrade to the API tier and copy your API key from the dashboard.
Get Your API Key