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

# Sandbox testing

> Test your UgaText integration for free with sandbox numbers and test API keys.

The sandbox lets you test your integration without deducting UGX balance.

## Sandbox numbers

Send to any of these numbers to trigger sandbox mode:

| Country | Number |
| - | - |
| Uganda | `+256700000000` (or `256700000000`) |
| Kenya | `+254700000000` |
| DR Congo | `+243810000000` |

These numbers also work with [OTP verification](https://docs.ugatext.com/otp-verification.md) for predictable, free testing.

Sandbox responses include `"mode": "sandbox"` and `"cost_ugx": 0`.

## Test API keys

You can also use a sandbox test key (`sk_test_...`). Generate one with `"mode": "test"` through `POST /auth/api-keys` or the dashboard. Requests made with a sandbox key return `"mode": "sandbox"`.

> [!NOTE]
>
> `GET /auth/verify` may report `"mode": "test"` for a test key. Message responses and webhooks always use `"mode": "sandbox"`.

## Bulk sends

In a bulk request, the response `mode` is `live`, `sandbox`, or `mixed` depending on the recipients.

> [!TIP]
>
> Use the sandbox in CI and staging so automated tests never send real messages or spend balance.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.