DEVELOPER API

G7DataPoint API Documentation

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.

Quick Start

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

Endpoints

Replace your-domain.com with the domain you use to access G7DataPoint.

MethodEndpointDescription
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

Price Plan IDs

Each service keeps its own catalogue. The price plan ID is the identifier you pass to the buy endpoint for that service.

Data Bundles

Field: price_plan_id → sent as data_plan. Includes network, type (SME/Gifting/Corporate), validity, cost price and your API price.

Cable TV

Field: price_plan_id → sent as cable_plan. Includes provider (DStv/GOtv/StarTimes), package name and validity.

Recharge Pins

Field: price_plan_id → sent as plan. Includes network, face value and your API price.

Data Pins

Field: price_plan_id. Includes network, pin value, type and validity.

Exam Pins

Field: plan_id → sent as provider. Includes provider name and price.

Electricity

Field: plan_id → sent as provider. Includes disco name and abbreviation.

Sample Response

{
  "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
      }
    ]
  }
}

Start Building With G7DataPoint

Create an account, upgrade to the API tier and copy your API key from the dashboard.

Get Your API Key