Developer API

Getting a key

Sign in, open Developer API in the menu, and generate a key. You confirm with an email code and your PIN; the key is shown once.

Authentication

Send your key on every request. Base URL: https://mbmobiledata.com/api/public/v1

Authorization: Bearer mbd_live_xxxxxxxxxxxx
# or
x-api-key: mbd_live_xxxxxxxxxxxx

Check balance

curl https://mbmobiledata.com/api/public/v1/balance \
  -H "Authorization: Bearer YOUR_KEY"

{ "balance": 15250.00, "currency": "NGN" }

Data Plan IDs & prices

Use the Plan ID below when buying data. Prices update automatically.

List data plans (API)

curl https://mbmobiledata.com/api/public/v1/plans -H "Authorization: Bearer YOUR_KEY"

{ "plans": [ { "plan_id": 2, "network": "MTN", "plan_type": "SME",
  "size": "1GB", "validity": "30 days", "price": 390 } ] }

Buy airtime or data

curl -X POST https://mbmobiledata.com/api/public/v1/purchase \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "category": "data", "network": "MTN", "phone": "08031234567",
        "plan_id": 2, "request_id": "order-1001" }'

# Airtime: "category": "airtime", "amount": 500 (50 – 50,000)

• request_id must be unique — repeating it never charges twice.
• Failed purchases are never charged.
• Responses include status, reference and your new balance.