> For the complete documentation index, see [llms.txt](https://capitalsage.gitbook.io/sagecloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://capitalsage.gitbook.io/sagecloud/airtime/purchase-airtime.md).

# Purchase Airtime

This endpoint allows you to purchase airtime.

## Purchase Airtime

<mark style="color:green;">`POST`</mark> `https://sagecloud.ng/api/v2/airtime`

Network codes include MTN, AIRTEL, GLO, 9MOBILE.\
\
Service codes include MTNVTU, AIRTELVTU, GLOVTU, 9MOBILEVTU.

#### Headers

| Name          | Type   | Description            |
| ------------- | ------ | ---------------------- |
| Authorization | string | Check the Headers page |

#### Request Body

| Name      | Type   | Description                   |
| --------- | ------ | ----------------------------- |
| reference | string | A unique key generated by you |
| network   | string | The network code              |
| service   | string | The service code              |
| phone     | string | Phone number of the recipient |
| amount    | string | Amount to be purchased        |

{% tabs %}
{% tab title="200 Airtime purchase successful.
NOTE: status can be "success" or "pending"" %}

```
{    
"success" : true, 
"status": "success",
"message" : "AIRTIME purchase successful"
}
```

{% endtab %}
{% endtabs %}
