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

> Get available data plans for a specific network

## Overview

Retrieve a list of available data plans for a specific network. This endpoint allows you to browse all data bundles offered by each network provider.

You can call this endpoint without a filter to retrieve the full catalog, or pass `network` to return plans for one network.

## Query Parameters

<RequestField name="network" type="string">
  Optional network filter. Supported values include `MTN`, `AIRTEL`, `GLOBACOM`, and `9MOBILE`.
</RequestField>

## Response

The `data` field is an array of data plan 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 the data plan belongs to.
</ResponseField>

<ResponseField name="operator" type="string">
  Operator identifier for the plan, when available.
</ResponseField>

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

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

<ResponseField name="voucherCode" type="string">
  Voucher code to submit as `voucherCode` when purchasing data.
</ResponseField>

<ResponseField name="description" type="string">
  Customer-readable description of the bundle and validity.
</ResponseField>

<ResponseField name="amount" type="number">
  Amount charged in Naira.
</ResponseField>

<ResponseField name="dataValue" type="number">
  Data value returned for the plan, when available.
</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": "oodwwrNrMbP9grMPFKVW",
  "data": [
    {
      "id": 12,
      "network": "MTN",
      "operator": "MTN",
      "productCode": "MTN_DATA_PRODUCT_CODE",
      "productGroup": "SME",
      "voucherCode": "MTN_DATA_VOUCHER_CODE",
      "description": "1GB — 30 days",
      "amount": 1000,
      "dataValue": 1024,
      "networkLogo": "https://cdn.bleeprs.com/logos/mtn.png"
    }
  ]
}
```

## Supported Networks

* **GLOBACOM** - Glo Nigeria data plans
* **AIRTEL** - Airtel Nigeria data plans
* **MTN** - MTN Nigeria data plans
* **9MOBILE** - 9mobile Nigeria data plans

## Notes

* Data plans vary by network and are updated regularly.
* Copy `productCode`, `voucherCode`, and `network` directly into [Purchase Data](/api-reference/endpoint/purchasedata).
* `amount` represents the amount charged in Naira.
* Descriptions include data amount and validity period.


## OpenAPI

````yaml GET /DataList
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:
  /DataList:
    get:
      tags:
        - Vending
      summary: List Data Plans
      description: Retrieve available data plans. You can optionally filter by network.
      operationId: dataList
      parameters:
        - name: network
          in: query
          required: false
          schema:
            type: string
            enum:
              - GLOBACOM
              - AIRTEL
              - MTN
              - 9MOBILE
          description: Optional network provider filter
      responses:
        '200':
          description: Successfully retrieved data plans
          content:
            application/json:
              schema:
                type: object
                properties:
                  gatewayStatus:
                    type: string
                    example: '00'
                  gatewayMessage:
                    type: string
                    example: Successfully Processed
                  requestReference:
                    type: string
                    example: oodwwrNrMbP9grMPFKVW
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                          example: 12
                        network:
                          type: string
                          example: MTN
                        operator:
                          type: string
                          description: Operator identifier for the plan, when available.
                          example: MTN
                        productCode:
                          type: string
                          description: >-
                            Product code to submit as productCode when
                            purchasing data.
                          example: MTN_DATA_PRODUCT_CODE
                        productGroup:
                          type: string
                          description: >-
                            Group the product belongs to. Empty when not
                            applicable.
                          example: SME
                        voucherCode:
                          type: string
                          description: >-
                            Voucher code to submit as voucherCode when
                            purchasing data.
                          example: MTN_DATA_VOUCHER_CODE
                        description:
                          type: string
                          description: >-
                            Customer-readable description of the bundle and
                            validity.
                          example: 1GB — 30 days
                        amount:
                          type: number
                          description: Amount charged in Naira.
                          example: 1000
                        dataValue:
                          type: number
                          description: Data value returned for the plan, when available.
                          example: 1024
                        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

````