Get started

The MELE DATA API lets you sell mobile-data top-ups and airtime across every Nigerian network — MTN, Glo, Airtel, and 9mobile — straight from your backend. Token auth, idempotent retries, and a shared wallet that any of your apps can debit.

curl --location 'https://meledata.ng/api/v1/developer/data/purchase' \
--header 'X-API-Key: mele_live_xxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
  "network": "MTN",
  "phone_number": "09012345678",
  "plan_id": 1,
  "reference": "order_001"
}'

Overview

MELE DATA Developers gives you two product APIs:

• Data API — buy mobile data on MTN, Glo, Airtel, and 9mobile. Per-plan pricing, idempotent retries.
• Airtime API — send airtime to any Nigerian number. Per-network discounts for resellers.
• Wallet balance NEW — a lightweight GET /wallet/ that returns your current balance, so your backend can check funds before queuing a buy.
• Status requery NEW — GET /data/status/?ref=… to look up any past purchase.

Base URL: https://meledata.ng/api/v1/developer. All responses are JSON. Money is Naira (₦) with up to 2 decimal places.

Authentication

Pass your API key in any of these headers — whichever your HTTP client makes easiest:

X-API-Key: mele_live_xxxxxxxxxxxxxxxxxxxxxxxx
# --or--
Authorization: Token mele_live_xxxxxxxxxxxxxxxxxxxxxxxx
# --or--
Authorization: Bearer mele_live_xxxxxxxxxxxxxxxxxxxxxxxx

Each token belongs to a single MELE DATA user. The token identifies whose wallet gets debited.

Supported Networks

Use these exact string values for the network field:

Check the balance your token can spend. Useful for showing a low-balance warning in your dashboard, gating a data buy before you call /data/purchase, or reconciling against your own ledger.

curl "https://meledata.ng/api/v1/developer/wallet/" \
  -H "X-API-Key: $TOKEN"

{
  "success": true,
  "data": {
    "balance":  14250.50,
    "display":  "₦14,250.50",
    "currency": "NGN",
    "livemode": true,
    "mode":     "live"
  }
}

Errors

Every non-2xx response uses the same envelope:

{
  "success": false,
  "error":   "insufficient_balance",
  "message": "Wallet balance is below the order total."
}

Idempotency

Every POST purchase endpoint requires a unique reference string in the request body. Retry with the same reference and you get back the original response — no double-debit, no duplicate work.

{
  "network": "MTN",
  "phone_number": "09012345678",
  "plan_id": 1,
  "reference": "order-2026-06-27-7f3a"   ← unique per purchase
}

References are scoped per-token; reuse across tokens has no effect. Keep references under 80 characters.

Data API

Mobile data top-ups

Quickstart

One endpoint: POST /data/purchase. Pick a plan from the live catalog below, send it with the customer's mobile number, and we route the top-up through the carrier.

curl --location 'https://meledata.ng/api/v1/developer/data/purchase' \
--header 'X-API-Key: mele_live_xxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
  "network": "MTN",
  "phone_number": "09012345678",
  "plan_id": 1,
  "reference": "unique_ref_001"
}'

Live plan catalog

Fetch all available plans programmatically via GET /data/plans. Use the plan_id column when calling POST /data/purchase.

curl "https://meledata.ng/api/v1/developer/data/plans" \
  -H "X-API-Key: $TOKEN"

{
  "plans": [
    {
      "plan_id":   1,
      "plan_code": "MTN_1GB_SME",
      "network":   "MTN",
      "plan_name": "MTN SME 1GB",
      "data_size": "1GB",
      "validity":  "30 days",
      "price":     290.00
    },
    {
      "plan_id":   5,
      "plan_code": "GLO_2GB",
      "network":   "GLO",
      "plan_name": "GLO 2GB",
      "data_size": "2GB",
      "validity":  "30 days",
      "price":     480.00
    }
  ]
}

Look up the current state of a single data purchase you already made. Use this when the original POST /data/purchase response was delayed or you want to reconcile against your own ledger.

Scope: a token only sees purchases it owns. Requests for a reference that belongs to another user return a clean 404.

curl "https://meledata.ng/api/v1/developer/data/status/?ref=DEV_DATA_order_001" \
  -H "X-API-Key: $TOKEN"

{
  "success": true,
  "data": {
    "reference":      "DEV_DATA_order_001",
    "status":         "delivered",
    "network":        "MTN",
    "mobile_number":  "09012345678",
    "plan":           "MTN_1GB_SME",
    "amount_charged": 290.00,
    "message":        "Data plan delivered to 09012345678 successfully.",
    "purchased_at":   "2026-06-27T10:58:02+00:00",
    "queried_at":     "2026-06-27T11:34:59+00:00",
    "livemode":       true,
    "mode":           "live"
  }
}

Airtime API

Mobile airtime top-ups