> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bleeprs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Airtime Networks

> Get all available airtime networks and their details

## 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

<ResponseField name="id" type="number">
  Unique catalog item ID.
</ResponseField>

<ResponseField name="network" type="string">
  Network name, such as `MTN`, `AIRTEL`, `GLOBACOM`, or `9MOBILE`.
</ResponseField>

<ResponseField name="operator" type="string">
  Operator identifier. Pass this value as `operator` when purchasing airtime.
</ResponseField>

<ResponseField name="region" type="string">
  Region for the plan (e.g. `NG`). Empty for plans without a region.
</ResponseField>

<ResponseField name="productCode" type="string">
  Product code to submit as `productCode` when purchasing airtime.
</ResponseField>

<ResponseField name="productGroup" type="string">
  Group the product belongs to. Empty when not applicable.
</ResponseField>

<ResponseField name="voucherCode" type="string">
  Voucher code to include as `voucherCode` when provided by the catalog.
</ResponseField>

<ResponseField name="minAmount" type="number">
  Minimum allowed airtime amount for this network, in Naira.
</ResponseField>

<ResponseField name="maxAmount" type="number">
  Maximum allowed airtime amount for this network, in Naira.
</ResponseField>

<ResponseField name="networkLogo" type="string">
  URL of the network logo, suitable for display in a UI.
</ResponseField>

## Example Response

```json theme={null}
{
  "gatewayStatus": "00",
  "gatewayMessage": "Successfully Processed",
  "requestReference": "MA1EF7AxNWuLz2Y0Jzfw",
  "data": [
    {
      "id": 1,
      "network": "MTN",
      "operator": "MTN",
      "region": "NG",
      "productCode": "MTN_AIRTIME_PRODUCT_CODE",
      "productGroup": "",
      "voucherCode": "",
      "minAmount": 100,
      "maxAmount": 50000,
      "networkLogo": "https://cdn.bleeprs.com/logos/mtn.png"
    }
  ]
}
```

## Notes

* Copy `productCode`, `voucherCode`, `operator`, and `region` directly into [Purchase Airtime](/api-reference/endpoint/purchaseairtime).
* 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.


## OpenAPI

````yaml GET /AirtimeList
openapi: 3.0.3
info:
  title: Bleeprs API Specification 0.1
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.bleeprs.com/api
security:
  - bearerAuth: []
paths:
  /AirtimeList:
    get:
      tags:
        - Vending
      summary: List Airtime Networks
      description: Get all available airtime networks and their details
      operationId: airtimeList
      responses:
        '200':
          description: Successfully retrieved airtime networks
          content:
            application/json:
              schema:
                type: object
                properties:
                  gatewayStatus:
                    type: string
                    example: '00'
                  gatewayMessage:
                    type: string
                    example: Successfully Processed
                  requestReference:
                    type: string
                    example: MA1EF7AxNWuLz2Y0Jzfw
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                          example: 1
                        network:
                          type: string
                          example: MTN
                        operator:
                          type: string
                          description: Pass this value as operator when purchasing airtime.
                          example: MTN
                        region:
                          type: string
                          description: >-
                            Region for the plan (e.g. NG). Empty for plans
                            without a region.
                          example: NG
                        productCode:
                          type: string
                          description: >-
                            Product code to submit as productCode when
                            purchasing airtime.
                          example: MTN_AIRTIME_PRODUCT_CODE
                        productGroup:
                          type: string
                          description: >-
                            Group the product belongs to. Empty when not
                            applicable.
                          example: ''
                        voucherCode:
                          type: string
                          description: >-
                            Voucher code to include as voucherCode when provided
                            by the catalog.
                          example: ''
                        minAmount:
                          type: number
                          description: >-
                            Minimum allowed airtime amount for this network, in
                            Naira.
                          example: 100
                        maxAmount:
                          type: number
                          description: >-
                            Maximum allowed airtime amount for this network, in
                            Naira.
                          example: 50000
                        networkLogo:
                          type: string
                          description: >-
                            URL of the network logo, suitable for display in a
                            UI.
                          example: https://cdn.bleeprs.com/logos/mtn.png
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````