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
amount	int	Amount to recharge
phone	string	Phone number
airtime_type	string	VTU, Share And Sell
ref	string	Unique Reference (Optional)

Request Body

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

Response Example

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

POST Purchase Data Bundle

Subscribe to data plans.

Parameters

Parameter	Type	Description
network	int	Network ID
phone	string	Phone number
data_plan	int	Plan ID (See Plan List)
ref	string	Unique Reference (Optional)

Request Body

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

POST Cable TV Subscription

Parameters

Parameter	Type	Description
cablename	string	GOTV, DSTV, STARTIMES, SHOWMAX
smart_card_number	string	IUC / Smart Card Number
cable_plan	int	Plan ID

Request Body

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

POST Electricity Bill Payment

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