API Documentation V1.0

Nigeria's most stable infrastructure for Airtime, Data, and Utility Bill Payments.

Get Started View Rates

Authentication

Requests are authenticated via API keys. Navigate to Dashboard > Settings > API to generate yours.

Security Warning: Never share your Secret Key. Keep it on your backend servers only.
Headers Required:
X-Api-Key: your_public_key Authorization: Bearer your_secret_key Content-Type: application/json

Base URL

All production requests should be sent to:

https://9jabillz.com.ng/api/v1/
POST

Airtime Vending

Recharge any Nigerian network (MTN, GLO, Airtel, 9mobile) instantly.

/airtime
Request Body:
{ "network": "MTN", "amount": 100, "phone": "08123456789" }
POST

Data Bundles

Purchase SME, Gifting, or Corporate data plans across all networks.

/data
Request Body:
{ "network": "MTN", "variation_code": "mtn-1gb-sme", "phone": "08012345678" }
POST

Electricity Tokens

Pay for prepaid/postpaid electricity across all Discos (AEDC, IKEDC, EKEDC, etc).

/electricity
Request Body:
{ "disco_code": "ikeja-electric", "meter_no": "04215324567", "meter_type": "prepaid", "amount": 2000, "phone": "08123456789" }
Success Response:
{ "status": "success", "token": "4521-8890-1234-5678-1122", "units": "45.2kWh", "amount": 2000, "reference": "9JB-PWR-123456" }
POST

Cable TV Subscription

Instantly renew DStv, GOtv, and StarTimes subscriptions.

/cable
Request Body:
{ "provider_code": "gotv", "package_code": "gotv-padi", "smart_card_no": "2022345678", "customer_name": "JOHN DOE", "phone": "08011111111" }
Success Response:
{ "status": "success", "message": "Cable Subscription Successful", "data": { "reference": "9JB-CAB-123456", "plan": "GOtv Padi" } }