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

# Fetch Data Plans

> Get a list of available data bundles that can be purchased based on the network or telco

<CardGroup cols={2}>
  <Card title="Fetch Data Plans" icon="link-simple" href="/nomba-api-reference/airtime-and-data-vending/fetch-data-plans-available-on-a-telco-network-provider" />
</CardGroup>

# `GET /v1/bill/data-plan/{telco}`

<Warning>
  The plans, amounts, and `productId`s in the example response are **illustrative only** — they do not represent real, current plans. This catalog can change at any time. Never hardcode plan data from this example: always call this endpoint live and use the `productId` it returns in your purchase request.
</Warning>

#### Path parameters

<ParamField path="telco" type="string" required>
  Telco i.e. network provider for the data plan to be purchased. Typically mtn,
  airtel, glo or 9mobile
</ParamField>

#### Response body

<ResponseField name="code" type="string" required>
  Response code
</ResponseField>

<ResponseField name="description" type="string" required>
  Response description
</ResponseField>

<ResponseField name="message" type="string" required>
  Response message
</ResponseField>

<ResponseField name="status" type="boolean" required>
  Request status
</ResponseField>

<ResponseField name="data" type="object[]">
  List of available data plans for the telco supplied

  <Expandable title="object" defaultOpen="true">
    <ResponseField name="amount" type="integer" required>
      The corresponding amount for this plan
    </ResponseField>

    <ResponseField name="plan" type="string" required>
      Plan name
    </ResponseField>

    <ResponseField name="productId" type="string" required>
      The unique identifier for this data plan. Pass this value as `productId` in the [Buy Data Bundle](/docs/products/airtime-and-data/buy-data-bundle) request to purchase this exact bundle.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl --location 'https://api.nomba.com/v1/bill/data-plan/mtn' \
  --header 'accountId: <accountId>' \
  --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json Success response (200) theme={null}
  {
      "code": "00",
      "description": "SUCCESS",
      "message": "SUCCESS",
      "status": true,
      "data": [
          {
              "plan": "20MB -> 1Day (N50)",
              "amount": 50,
              "productId": "example-plan-id-1"
          },
          {
              "plan": "75MB -> 1Day (N100)",
              "amount": 100,
              "productId": "example-plan-id-2"
          },
          {
              "plan": "200MB -> 3Days (N200)",
              "amount": 200,
              "productId": "example-plan-id-3"
          },
          {
              "plan": "350MB -> 7Days (N300)",
              "amount": 300,
              "productId": "example-plan-id-4"
          },
          {
              "plan": "750MB -> 14Days (N500)",
              "amount": 500,
              "productId": "example-plan-id-5"
          },
          {
              "plan": "1.5GB -> 30Days (N1,000)",
              "amount": 1000,
              "productId": "example-plan-id-6"
          },
          {
              "plan": "3.5GB -> 30Days (N1,500)",
              "amount": 1500,
              "productId": "example-plan-id-7"
          },
          {
              "plan": "5.5GB -> 30Days (N2,500)",
              "amount": 2500,
              "productId": "example-plan-id-8"
          }
      ]
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.