Skip to main content
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

The data 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.
URL of the network logo, suitable for display in a UI.

Example Response

Notes

  • Copy productCode, voucherCode, operator, and region directly into Purchase Airtime.
  • Use minAmount and maxAmount to validate customer input before submitting a purchase.
  • The catalog can change, so refresh it regularly instead of hard-coding network options.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200 - application/json

Successfully retrieved airtime networks

gatewayStatus
string
Example:

"00"

gatewayMessage
string
Example:

"Successfully Processed"

requestReference
string
Example:

"MA1EF7AxNWuLz2Y0Jzfw"

data
object[]