API Documentation

Back to Website

Welcome to the Demboss Data Developer API. Integrate our services (Airtime, Data, Cable TV, Electricity, and more) directly into your applications.

Base URL: https://dembossdata.com/api/v1/

Authentication

All API requests must be authenticated using your API Token. You can find your API Token in your dashboard settings.

Pass the token in the request Header:

Authorization: Token YOUR_API_TOKEN_HERE

Or as Authorization: Bearer YOUR_API_TOKEN_HERE

GET Get User Details

Retrieve your current account balance and details.

Endpoint

https://dembossdata.com/api/v1/

Response Example

{
    "status": "success",
    "msg": "User Details Fetched",
    "name": "User Name",
    "balance": "5,000.00",
    "Status": "successful"
}

POST Purchase Airtime

Top up airtime for any network.

Parameters

Parameter	Type	Description
network	int	Network ID (1=MTN, 2=GLO, 3=9MOBILE, 4=AIRTEL)
amount	int	Amount to recharge (e.g., 100)
phone	string	Phone number (11 digits)
airtime_type	string	VTU, Share And Sell
ref	string	Unique Reference (Optional, auto-generated)

Request Body

{
    "network": "1",
    "amount": "100",
    "phone": "08012345678",
    "airtime_type": "VTU"
}

Response Example

{
    "status": "success",
    "Status": "successful",
    "msg": "Transaction Successful"
}

POST Purchase Data Bundle

Integrate and subscribe to our data plans using the Plan IDs. View all Data Plans & IDs →

Parameters

Parameter	Type	Description
network	int	Network ID (1=MTN, 2=GLO, 3=9MOBILE, 4=AIRTEL)
phone	string	Phone number
data_plan	int	Internal Plan ID (pId) – see Data Plans page
ref	string	Unique Reference (Optional)

Request Body

{
    "network": "1",
    "phone": "08012345678",
    "data_plan": "171"
}

POST Cable TV Subscription

Renew cable TV subscriptions using the Cable Plan IDs. View all Cable Plans & IDs →

Parameters

Parameter	Type	Description
cablename	string	GOTV, DSTV, STARTIMES, SHOWMAX
smart_card_number	string	IUC / Smart Card Number
cable_plan	int	Internal Plan ID (cpId) – see Cable Plans page

Request Body

{
    "cablename": "GOTV",
    "smart_card_number": "1234567890",
    "cable_plan": "47"
}

POST Electricity Bill Payment

Pay electricity bills. Use the exact Disco Name as listed. View all Electricity Providers & IDs →

Parameters

Parameter	Type	Description
disco_name	string	Provider Name (e.g., "Ikeja Electric")
meter_number	string	Meter Number
amount	int	Amount to pay
meter_type	string	"Prepaid" or "Postpaid"

Request Body

{
    "disco_name": "Ikeja Electric",
    "meter_number": "1234567890",
    "amount": "1000",
    "meter_type": "Prepaid"
}

Success Response (Includes Token)

{
    "status": "success",
    "Status": "successful",
    "msg": "Transaction Successful",
    "token": "1234-5678-9012-3456"
}

POST Exam PINs

Parameters

Parameter	Type	Description
exam_name	string	WAEC, NECO, JAMB, NABTEB
quantity	int	Number of PINs

Request Body

{
    "exam_name": "WAEC",
    "quantity": "1"
}

Success Response (Includes PINs)

{
    "status": "success",
    "Status": "successful",
    "msg": "Transaction Successful",
    "pins": "WAEC-123456789012"
}

Reference IDs

Network IDs

ID	Network
1	MTN
2	GLO
3	9MOBILE
4	AIRTEL

Cable Providers

Name	Description
GOTV	GOtv Nigeria
DSTV	DStv Nigeria
STARTIMES	StarTimes
SHOWMAX	Showmax

Electricity Providers (Discos)

Ikeja Electric Eko Electric Abuja Electric Kano Electric Port Harcourt Electric Jos Electric Kaduna Electric Enugu Electric Ibadan Electric Benin Electric

📋 Complete Plan ID lists: Data Plans | Cable Plans | Electricity Providers