Developer API V1.1

Scale your VTU business with 9jaBillz high-performance API endpoints.

API Base URL

All API requests should be directed to the root endpoint below. Ensure you use HTTPS for all calls.

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

Authentication

Authenticate your requests by passing your keys in the HTTP headers. Keys are available in your Reseller > API settings.

X-Api-Key: your_public_api_key Authorization: Bearer your_secret_key Content-Type: application/json
GET

Check Balance

/balance

Retrieve real-time wallet and cashback assets.

Success Response:
{ "status": "success", "wallet_balance": 15000.50, "cashback_balance": 250.00, "user_tier": "Reseller" }
POST

Airtime Top-up

/airtime

{ "network": "mtn", "amount": 500, "phone": "08123456789", "request_id": "RESELLER_REF_001" }
POST

Data Bundles

/data

{ "network": "glo", "plan_id": "glo-100mb", "phone": "08050000000", "request_id": "RESELLER_REF_002" }
POST

Electricity Tokens

/electricity

{ "disco_code": "ikeja-electric", "meter_no": "04215324567", "meter_type": "prepaid", "amount": 2000, "customer_name": "JOHN DOE", "phone": "08123456789" }
POST

Cable TV Sub

/cable

{ "provider": "dstv", "package_code": "dstv-padi", "smart_card_no": "1022345678", "customer_name": "JANE DOE", "request_id": "RESELLER_REF_003" }
POST

Education Pins

/education

{ "service_id": 1, "phone": "08123456789", "profile_id": "5566778899", "request_id": "RESELLER_REF_004" }