List Airtime Networks
Vending
List Airtime Networks
Get all available airtime networks and their details
GET
List Airtime Networks
Overview
Retrieve a list of all available airtime networks with their pricing, limits, and other relevant information. No parameters required for this endpoint.Response
Thedata field is an array of network entries. Each entry contains the fields below.
Response Fields
number
Unique catalog item ID.
string
Network name, such as
MTN, AIRTEL, GLOBACOM, or 9MOBILE.string
Operator identifier. Pass this value as
operator when purchasing airtime.string
Region for the plan (e.g.
NG). Empty for plans without a region.string
Product code to submit as
productCode when purchasing airtime.string
Group the product belongs to. Empty when not applicable.
string
Voucher code to include as
voucherCode when provided by the catalog.number
Minimum allowed airtime amount for this network, in Naira.
number
Maximum allowed airtime amount for this network, in Naira.
string
URL of the network logo, suitable for display in a UI.
Example Response
Notes
- Copy
productCode,voucherCode,operator, andregiondirectly into Purchase Airtime. - Use
minAmountandmaxAmountto validate customer input before submitting a purchase. - The catalog can change, so refresh it regularly instead of hard-coding network options.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.