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

# Plans & Catalogs

> Fetch the plan IDs, network IDs and codes the purchase endpoints expect.

The purchase endpoints reference plans and providers by **ID / code**. Fetch the current values from these catalog endpoints, then pass them into the matching purchase call. All catalog endpoints are authenticated with your `Token` API key.

## Data plan IDs

Use this to get the `data_plan` value for [Buy Data](/reference/data). Every plan includes its `plan_id`, `network`, `name`, `amount` and `network_type`.

```http theme={null}
GET https://api.mysubwallet.ng/api/data-plan
```

```bash cURL theme={null}
curl "https://api.mysubwallet.ng/api/data-plan" \
  -H "Authorization: Token your_api_key"
```

```json Response theme={null}
{
  "status": "success",
  "plan": [
    {
      "network": "GLO",
      "network_type": "GIFTING",
      "name": "750MB GIFTING = ₦194.00 1 Day Special",
      "plan_id": "19",
      "amount": "194"
    },
    {
      "network": "MTN",
      "network_type": "GIFTING",
      "name": "2.7GB GIFTING = ₦1,900.00 1 Month",
      "plan_id": "31",
      "amount": "1900"
    }
  ]
}
```

<Tip>
  Try it live in the [List Data Plans](/reference/data-plans) playground.
</Tip>

## Network IDs

Most endpoints accept a numeric `network` ID:

| ID | Network |
| -- | ------- |
| 1  | MTN     |
| 2  | Airtel  |
| 3  | Glo     |
| 4  | 9mobile |

## Other catalogs

All are `GET` and authenticated with your `Token` API key — try each in the playground.

| Catalog                                   | Endpoint               | Used by                                                            |
| ----------------------------------------- | ---------------------- | ------------------------------------------------------------------ |
| [Networks](/reference/networks)           | `GET /api/networks`    | the `network` field everywhere                                     |
| [DISCOs (electricity)](/reference/discos) | `GET /api/discos`      | [Pay Electricity Bill](/reference/electricity) — the `disco` field |
| [Cable plans](/reference/cable-plans)     | `GET /api/cable-plans` | [Cable Subscription](/reference/cable) — the `cableplan` value     |
| [Exam bodies](/reference/exam-bodies)     | `GET /api/exam-bodies` | [Buy Exam Pins](/reference/exam) — the `exam` field                |

<Note>
  Plan IDs and codes are also listed on the dashboard's **Pricing & Plan IDs** page.
</Note>