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

# Introduction

> Send airtime credit directly to mobile numbers on supported networks via API.

The **Beem Airtime Topup API** lets you send airtime credit directly to any mobile number on supported networks. The API is designed for quick integration into your application.

<CardGroup cols={2}>
  <Card title="Instant top-up">
    Send airtime to subscribers on supported mobile networks programmatically.
  </Card>

  <Card title="Async delivery">
    Receive a callback with the final recharge status once processing completes.
  </Card>
</CardGroup>

***

## Sending airtime flow

```text theme={null}
Your Application
      │
      │ 1. POST /v1/transfer
      ▼
Beem Airtime API
      │
      │ 2. Validate request
      ▼
Acknowledgement response
      │
      │ 3. Forward to Mobile Network Operator
      ▼
Mobile Network Operator
      │
      │ 4. Processing result
      ▼
Beem Airtime API
      │
      │ 5. POST callback (if configured)
      ▼
Your Application receives final status
```

<Steps>
  <Step title="Submit request">
    Your application sends an airtime recharge request to the Beem API.
  </Step>

  <Step title="Validation">
    The API accepts and validates the request, returning an immediate acknowledgement or an error if the request is invalid.
  </Step>

  <Step title="Operator processing">
    Beem forwards the request to the mobile network operator and receives the operator response.
  </Step>

  <Step title="Callback">
    If a callback URL is configured on your profile, Beem sends the final recharge status to your server.
  </Step>
</Steps>

***

## Base URLs

| Purpose                       | URL                              |
| ----------------------------- | -------------------------------- |
| Transfer & transaction status | `https://apiairtime.beem.africa` |
| Credit balance                | `https://apitopup.beem.africa`   |

***

## What's in this section

* [Prerequisites](/guides/airtime/prerequisites) — account setup and API credentials
* [Authentication](/guides/airtime/authentication) — Basic Auth or access token
* [Sending airtime](/guides/airtime/sending-airtime) — transfer request, parameters, and sample code
* [Callbacks](/guides/airtime/callbacks) — receive final transaction status
* [Transaction status](/guides/airtime/transaction-status) — poll status by transaction ID
* [Check balance](/guides/airtime/check-balance) — retrieve your available credit balance
* [Response codes](/guides/airtime/response-codes) — API status and error codes