---
title: "Queue an airtime order"
method: POST
path: "/api/airtime.php"
tags: ["Airtime"]
---

# Queue an airtime order

`POST /api/airtime.php`

## Request

- Base URL: `https://simcloud.co.za`
- URL: `https://simcloud.co.za/api/airtime.php`
- Auth: HTTP bearer

The same MSISDN and amount cannot be ordered again within 5 minutes. Duplicate requests inside that window return HTTP 409.

## Request body

- object
  - `msisdn` string, required
  - `network` string, required: Accepts friendly names or internal codes.
  - `amount` number, float, required
  - `reference` string, required

## Response `201`

Airtime order queued

## Other responses

- `400`: Validation or balance error
- `401`: Unauthorized
- `409`: Duplicate order within the 5-minute rule window

---

[API](https://skmtc.dev/simcloud/apis/simcloud-api.md) · [All operations](https://skmtc.dev/simcloud/apis/simcloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/simcloud/apis/simcloud-api/revisions/464f67ea710f?raw)