List billers
Bearer ds_live_ / ds_test_GET
/api/v1/merchant/billersReturns every biller enabled for the API (networks, discos, cable providers, exam bodies, betting platforms…) with their plans and your effective prices. Use the biller slug as biller and the plan id as product_id in purchases.
Live product catalog
Prices depend on your account pricing group. Sign in to browse the billers and plans, and copy the slugs and plan ids you need for API requests.
Language
curl -X GET "https://finaldatasub.com/api/v1/merchant/billers?category=data,airtime&include_plans=true" \
-H "Authorization: Bearer ds_live_YOUR_KEY" \
-H "Accept: application/json"Authentication
Send your secret API key in the header. Authorization: Token … and X-API-Key: … are also accepted.
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer ds_live_YOUR_KEY | Yes |
| Accept | application/json | Recommended |
Authentication failures (401 UNAUTHORIZED, 403 IP_NOT_ALLOWED / ACCOUNT_SUSPENDED / API_ACCESS_NOT_APPROVED, 429 RATE_LIMITED) are listed in Authentication.
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| category | string | No | Comma-separated categories: data, airtime, electricity, cable, education, betting, internet, voice, bulk_sms, rechargepin, giftcard, esim. exam is accepted as an alias for education. Only categories enabled for the API are returned. |
| include_plans | boolean | No | Include each biller's plans (default true). Send false for a lighter response. |
Responses
200 OK — OK
{
"count": 2,
"data": [
{
"id": 7,
"name": "MTN Airtime",
"slug": "mtn-airtime",
"code": "MTN",
"category": "airtime",
"network": "MTN",
"logo_url": "https://cdn.example.com/billers/mtn.png",
"description": "MTN VTU airtime",
"status": "active",
"sort_order": 1,
"is_featured": true,
"supports_validation": false,
"min_amount": 50,
"max_amount": 50000,
"airtime_type": "VTU",
"rate_per_100": 97,
"cashback_per_100": 0,
"plans": []
},
{
"id": 3,
"name": "MTN Data",
"slug": "mtn-data",
"code": "MTN",
"category": "data",
"network": "MTN",
"logo_url": "https://cdn.example.com/billers/mtn.png",
"description": "MTN data bundles",
"status": "active",
"sort_order": 1,
"is_featured": true,
"supports_validation": false,
"min_amount": null,
"max_amount": null,
"plans": [
{
"id": 212,
"name": "MTN SME 1GB - 30 Days",
"code": "mtn-sme-1gb",
"description": "",
"size": "1GB",
"plan_type": "SME",
"plan_type_slug": "sme",
"amount": 500,
"currency": "NGN",
"validity_days": 30,
"is_variable_amount": false,
"min_amount": null,
"max_amount": null,
"sort_order": 1,
"is_special": false,
"msorg_plan_id": 212,
"adex_plan_id": 212,
"effective_amount": 480,
"effective_fee": 0,
"effective_total": 480,
"cashback": 0,
"benefit_type": "discount",
"benefit_label": "₦20.00 off"
}
]
}
]
}Notes
- Airtime billers also return
airtime_type(VTU,Share and Sellorawuf4U),rate_per_100(what you pay per ₦100 of airtime) andcashback_per_100. Each type is its own biller on the same network. effective_totalis what you will be charged for a plan;benefit_typeisdiscount,cashbackor null.msorg_plan_idandadex_plan_idequalid— use them with the legacy MSORG / Adex endpoints.