Skip to main content
GET
/
airtimeList
curl --location 'https://api.bleeprs.com/api/airtimeList' \
--header 'Authorization: Bearer YOUR_API_KEY'

{
  "gatewayStatus": "<string>",
  "gatewayMessage": "<string>",
  "requestReference": "<string>",
  "data": [
    {}
  ],
  "ID": 123,
  "Network": "<string>",
  "Operator": "<string>",
  "Region": "<string>",
  "MinAmount": 123,
  "MaxAmount": 123,
  "Percentage": 123,
  "NetworkLogo": "<string>",
  "VoucherCode": "<string>",
  "CreatedAt": "<string>",
  "UpdatedAt": "<string>"
}

​
Overview

Retrieve a list of all available airtime networks with their pricing, limits, and other relevant information.

​
Request

curl --location 'https://api.bleeprs.com/api/airtimeList' \
--header 'Authorization: Bearer YOUR_API_KEY'

​
Parameters

No parameters required for this endpoint.

​
Response

​
gatewayStatus
string
Status code indicating success (“00”) or error
​
gatewayMessage
string
Human-readable status message
​
requestReference
string
Unique reference ID for tracking this request
​
data
array
Array of available airtime networks

​
Data Object Fields

​
ID
number
Unique identifier for the network
​
Network
string
Network name (e.g., “MTN”, “AIRTEL”, “GLOBACOM”, “9MOBILE”)
​
Operator
string
Operator type (e.g., “AIRTIME”)
​
Region
string
Geographic region (e.g., “MTN”, “AIRTEL”)
​
MinAmount
number
Minimum airtime amount that can be purchased
​
MaxAmount
number
Maximum airtime amount that can be purchased
​
Percentage
number
Commission percentage for this network
Network logo identifier
​
VoucherCode
string
Voucher code for this network (e.g., “LA_MTN”)
​
CreatedAt
string
Timestamp when the network was added
​
UpdatedAt
string
Timestamp when the network was last updated

​
Example Response

{
  "gatewayStatus": "00",
  "gatewayMessage": "Successfully Processed",
  "requestReference": "MA1EF7AxNWuLz2Y0Jzfw",
  "data": [
    {
      "ID": 9,
      "Network": "9MOBILE",
      "Operator": "AIRTIME",
      "Region": "9MOBILE",
      "MinAmount": 10,
      "MaxAmount": 30000,
      "Percentage": 4,
      "NetworkLogo": "9MOBILE",
      "VoucherCode": "LA_9MOBILE",
      "CreatedAt": "2025-09-17T16:40:27.896462Z",
      "UpdatedAt": "2025-09-17T16:40:27.896462Z"
    },
    {
      "ID": 10,
      "Network": "AIRTEL",
      "Operator": "AIRTIME",
      "Region": "AIRTEL",
      "MinAmount": 10,
      "MaxAmount": 30000,
      "Percentage": 3,
      "NetworkLogo": "AIRTEL",
      "VoucherCode": "LA_AIRTEL",
      "CreatedAt": "2025-09-17T16:40:27.899724Z",
      "UpdatedAt": "2025-09-17T16:40:27.899724Z"
    },
    {
      "ID": 11,
      "Network": "GLOBACOM",
      "Operator": "AIRTIME",
      "Region": "GLOBACOM",
      "MinAmount": 10,
      "MaxAmount": 30000,
      "Percentage": 2,
      "NetworkLogo": "GLOBACOM",
      "VoucherCode": "LA_GLOBACOM",
      "CreatedAt": "2025-09-17T16:40:27.900359Z",
      "UpdatedAt": "2025-09-17T16:40:27.900359Z"
    },
    {
      "ID": 12,
      "Network": "MTN",
      "Operator": "AIRTIME",
      "Region": "MTN",
      "MinAmount": 10,
      "MaxAmount": 30000,
      "Percentage": 1,
      "NetworkLogo": "MTN",
      "VoucherCode": "LA_MTN",
      "CreatedAt": "2025-09-17T16:40:27.900783Z",
      "UpdatedAt": "2025-09-17T16:40:27.900783Z"
    }
  ]
}