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

# Quickstart

> Make your first successful purchase in minutes.

This guide walks you through buying a data bundle end-to-end.

<Steps>
  <Step title="Fund your wallet">
    Sign in to the [dashboard](https://app.mysubwallet.ng) and top up your balance. API purchases are debited from this balance.
  </Step>

  <Step title="Get your API key">
    Follow [Authentication](/authentication) to retrieve your `AccessToken`.
  </Step>

  <Step title="Buy a data bundle">
    Send an authenticated `POST` request to `/api/data` with a unique `request-id`.

    ```bash theme={null}
    curl -X POST "https://api.mysubwallet.ng/api/data" \
      -H "Authorization: Token your_api_key" \
      -H "Content-Type: application/json" \
      -d '{
        "network": 1,
        "phone": "2347013397088",
        "data_plan": 1,
        "bypass": false,
        "request-id": "Data_12345678900"
      }'
    ```
  </Step>

  <Step title="Read the response">
    A `status` of `success` means the bundle was delivered and your wallet was debited.

    ```json theme={null}
    {
      "network": "MTN",
      "request-id": "Data_12345678900",
      "amount": "100",
      "dataplan": "500MB",
      "status": "success",
      "message": "You have gifted 500MB to 2347013397088.",
      "phone_number": "2347013397088",
      "newbal": 110225,
      "system": "API"
    }
    ```
  </Step>
</Steps>

<Check>
  That's it — you've made your first API purchase. Browse the [API Reference](/reference/data) for every available endpoint.
</Check>

## Network IDs

Most endpoints accept a numeric `network` ID:

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

<Note>
  Data and cable plans use **plan IDs** that you can fetch from the dashboard's **Pricing & Plan IDs** page or the relevant catalog endpoint.
</Note>