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

# Response codes

> Airtime API status and error codes.

The Airtime API returns numeric codes to indicate transaction status and errors.

***

## Transaction status codes

| Code  | Description                       |
| ----- | --------------------------------- |
| `100` | Disbursement successful           |
| `101` | Disbursement failed               |
| `102` | Invalid phone number              |
| `103` | Insufficient balance              |
| `104` | Network timeout                   |
| `105` | Invalid parameters                |
| `106` | Amount too large                  |
| `107` | Account not found                 |
| `108` | No route mapping to your account  |
| `109` | No authorization headers          |
| `110` | Invalid token                     |
| `111` | Missing destination MSISDN number |
| `112` | Missing disbursement amount       |
| `113` | Invalid disbursement amount       |
| `114` | Disbursement pending              |

***

## Common scenarios

<AccordionGroup>
  <Accordion title="100 — Disbursement successful">
    The airtime was successfully delivered to the recipient. You will receive this code in callbacks and transaction status responses when the transfer completes.
  </Accordion>

  <Accordion title="103 — Insufficient balance">
    Your account does not have enough credit to complete the transfer. Top up your balance before retrying.
  </Accordion>

  <Accordion title="102 — Invalid phone number">
    The `dest_addr` value is not a valid mobile number in international format. Ensure the number includes the country code with no leading `+`.
  </Accordion>

  <Accordion title="114 — Disbursement pending">
    The transfer is still being processed. Poll [Transaction status](/guides/airtime/transaction-status) or wait for a [Callback](/guides/airtime/callbacks).
  </Accordion>

  <Accordion title="120 — Invalid authentication">
    Your API Key or Secret is incorrect. Regenerate credentials from **Airtime → API Setup** if needed.
  </Accordion>
</AccordionGroup>

***

## HTTP status codes

| HTTP Status   | Typical cause                                |
| ------------- | -------------------------------------------- |
| `200` / `201` | Request accepted or completed successfully   |
| `400`         | Invalid request parameters or missing fields |
| `401`         | Invalid or missing authentication            |