⚡ Developer Documentation

Integrate all services with our REST API

Direct access to data bundles, airtime, ECG electricity, Ghana Water, and DStv/GOtv subscriptions. Dual carrier routing with 99.9% uptime.

MTN · Telecel · AirtelTigoECG & GWCL UtilitiesCable TV (DStv, GOtv, StarTimes)

API Key Authentication

Authenticate your requests by including your secret API key in the Authorization: Bearer <API_KEY> or x-api-key: <API_KEY> HTTP header.

AUTHORIZATION HEADER

Authorization: Bearer fa_sec_live_your_api_key_here

GET

List Available Services & Wholesale Pricing

Endpoint: /api/v1/services. Query all packages with retail, agent, and API partner rates. Filters: ?type=data, ?network=MTN.

CURL REQUEST

curl -X GET https://quicknetdata.com/api/v1/services \
  -H "Authorization: Bearer fa_sec_live_your_api_key_here"

SAMPLE JSON RESPONSE

{
  "status": "success",
  "count": 22,
  "data": [
    {
      "id": "MTN_5GB",
      "name": "MTN Data 5GB",
      "type": "data",
      "network": "MTN",
      "volume": "5GB",
      "retail_price": 23.00,
      "agent_price": 21.00,
      "api_price": 20.20,
      "validity": "Non-Expiry",
      "status": "available"
    },
    {
      "id": "AIRTIME_MTN",
      "name": "MTN Airtime Top-Up",
      "type": "airtime",
      "network": "MTN",
      "retail_price": 1.00,
      "agent_price": 0.97,
      "api_price": 0.96,
      "status": "available"
    }
  ]
}

GET

Check Partner Wallet Balance

Endpoint: /api/v1/wallet/balance. Returns your developer wallet balance in Ghanaian Cedis (GHS).

CURL REQUEST

curl -X GET https://quicknetdata.com/api/v1/wallet/balance \
  -H "Authorization: Bearer fa_sec_live_your_api_key_here"

POST

Unified Purchase Endpoints

Purchase any telecom package or utility service. Debits your developer wallet at API wholesale partner pricing.

1. Data Bundle Recharge (`/api/v1/data` or `/api/v1/transaction/purchase`)

BUY DATA BUNDLE

curl -X POST https://quicknetdata.com/api/v1/data \
  -H "Authorization: Bearer fa_sec_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "MTN_10GB",
    "recipient": "0241234567",
    "network": "MTN",
    "request_id": "TXN_CLIENT_99218"
  }'

2. Airtime Top-Up (`/api/v1/airtime`)

BUY AIRTIME

curl -X POST https://quicknetdata.com/api/v1/airtime \
  -H "Authorization: Bearer fa_sec_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "0559876543",
    "amount": 20.00,
    "network": "MTN",
    "request_id": "TXN_AIR_55412"
  }'

3. Electricity, Water & Cable TV (`/api/v1/bills`)

PAY BILL

curl -X POST https://quicknetdata.com/api/v1/bills \
  -H "Authorization: Bearer fa_sec_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "account_number": "14120938491",
    "amount": 50.00,
    "network": "ECG",
    "request_id": "TXN_ECG_88201"
  }'

PURCHASE SUCCESS RESPONSE

{
  "status": "success",
  "data": {
    "reference": "TXN_CLIENT_99218",
    "provider_reference": "DMG_ORD_449102",
    "service": "MTN Data 10GB",
    "network": "MTN",
    "recipient": "0241234567",
    "amount_debited": 38.00,
    "currency": "GHS",
    "transaction_status": "delivered",
    "message": "Data bundle dispatched successfully",
    "created_at": "2026-10-07T17:30:05Z"
  }
}

GET

Check Transaction Status

Endpoint: /api/v1/transaction/status/[reference]. Query the live fulfillment status across carrier gateways.

QUERY STATUS

curl -X GET https://quicknetdata.com/api/v1/transaction/status/TXN_CLIENT_99218 \
  -H "Authorization: Bearer fa_sec_live_your_api_key_here"