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

# Buy Airtime

> With this endpoint, your end users can easily buy Airtime across all mobile network

Buy airtime across all mobile networks

```http [POST] theme={null}
{{baseUrl}}/api/v1/purchase/airtime
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

| Parameter              | Type     | Description                      | Required |
| ---------------------- | -------- | -------------------------------- | -------- |
| amount *required*      | *number* | amount of airtime                | required |
| destination *required* | *array*  | number(s) to receive the airtime | required |

```json Response theme={null}
{
    "entity": {
        "status": "Sent",
        "mobile": "+2348102152847",
        "amount": "NGN 200.0000"
    }
}
```

### Response Fields

| Field         | Type   | Description                                                 |
| ------------- | ------ | ----------------------------------------------------------- |
| entity        | object | Contains the response data                                  |
| entity.status | string | Status of the airtime purchase (e.g., "Sent")               |
| entity.mobile | string | Mobile number that received the airtime                     |
| entity.amount | string | Amount of airtime sent with currency (e.g., "NGN 200.0000") |