datavendor.ng merchant API
API Documentation
REST API for data, airtime, cable TV, electricity, exam pins, recharge cards and bulk SMS. Authenticate with your token and call the live base URL below.
Base URL
https://datavendor.ng/api/get/network/Pricing & Plan IDs
Rates and identifiers for your API account
api:readAll plan IDs, network IDs, cable packages, disco IDs and SMS rates are tied to your API user type. Use the endpoints below or the in-app Pricing page to look up values before purchase.
Open live pricing tablesDashboard pricing page
Open Dashboard → Pricing for readable tables: data plan IDs, airtime discount percentages, cable packages, electricity disco IDs, exam pin prices and bulk SMS rates.
API pricing endpoint
Call GET /api/get/network/ to retrieve networks, data plan IDs and amounts in JSON. Cable, exam and SMS pricing is available from the legacy user-data payload and dashboard pricing views.
Use IDs in purchase calls
Pass the `id` from data_plans as `plan`, network `id` as `network`, cable plan `id` as `plan`, and disco `id` as `disco_name` when buying.
Required headers
| Header | Value | Required |
|---|---|---|
| Authorization | Token YOUR_API_TOKEN | Yes |
| Content-Type | application/json | Yes (POST/PUT) |
| Accept | application/json | Recommended |
Endpoint
https://datavendor.ng/api/get/network/Parameters / payload fields
| Resource | Where to find IDs | Used in |
|---|---|---|
| Data plans | GET /api/get/network/ or Dashboard → Pricing | POST /api/data/ (`plan`, `network`) |
| Airtime discount | Dashboard → Pricing → Airtime tab | POST /api/topup/ |
| Cable packages | Dashboard → Pricing → Cable tab | POST /api/cablesub/ (`plan`) |
| Disco IDs | Dashboard → Pricing → Electricity tab | POST /api/billpayment/ (`disco_name`) |
| Exam pins | Dashboard → Pricing → Exam pins tab | POST /api/epin/ |
| Bulk SMS | Dashboard → Pricing → Bulk SMS tab | POST /api/sendsms/ |
Code samples
curl -X GET "https://datavendor.ng/api/get/network/" \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Accept: application/json"Response sample (200)
{
"MTN": {
"network_info": { "id": 1, "name": "MTN" },
"data_plans": [
{ "id": 212, "plan_size": "1", "plan_Volume": "GB", "plan_amount": "500.00", "plan_type": "SME" }
]
}
}