Airtime billers

X-API-Key

GET/airtime/billers

charge_percent is the API rate (api_charge_percent on the biller). you_pay_preview is the wallet debit for ₦100 face. Display name for 9mobile is **T2**; code stays 9MOBILE.

Language

curl -X GET "https://api.vendpower.ng/api/v1/airtime/billers" \
  -H "X-API-Key: YOUR_X_API_KEY" \
  -H "Accept: application/json"

Authentication

Send your approved API key on every request. Keep it on your server only.

Header	Value	Required
X-API-Key	YOUR_X_API_KEY	Yes
Accept	application/json	Recommended

Authentication failures (401 / 403 / 429) are listed in Authentication.

Parameters

This endpoint takes no parameters.

Responses

200 OK — Billers

{
  "success": true,
  "message": "Airtime billers retrieved.",
  "data": [
    {
      "id": 201,
      "name": "MTN",
      "code": "MTN",
      "network": "MTN",
      "min_amount": 50,
      "max_amount": 50000,
      "charge_percent": 100,
      "you_pay_preview": 100
    },
    {
      "id": 204,
      "name": "T2",
      "code": "9MOBILE",
      "network": "9MOBILE",
      "min_amount": 50,
      "max_amount": 50000,
      "charge_percent": 100,
      "you_pay_preview": 100
    }
  ]
}

Response fields

Field	Type	Description
id	number	Biller id
name	string	Display name (T2 for 9mobile)
code	string	Purchase code — use `9MOBILE` for T2
network	string	Canonical network code
min_amount / max_amount	number	Allowed face amounts (NGN)
charge_percent	number	API wallet rate (% of face)
you_pay_preview	number	Wallet debit preview for ₦100 face