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

# Rate limits

> Each API key has its own request limit, counted over a sliding window.

By default each key can make **120 requests per minute**, counted over a sliding 60-second window. The limit is per key, so separate systems with their own keys don't slow each other down.

## When you go over

You get `429` and nothing is processed. The headers say when to try again:

```http theme={null}
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1762939867000
Retry-After: 14

{ "error": "Too many requests. Please try again later." }
```

| Header | Meaning |
| - | - |
| `X-RateLimit-Limit` | Requests allowed in the window. |
| `X-RateLimit-Remaining` | Requests left in the window. |
| `X-RateLimit-Reset` | When the window resets, as Unix time in milliseconds. |
| `Retry-After` | Seconds to wait before retrying. |

Wait `Retry-After` seconds, then retry. A ready-made retry helper is on the [Errors](https://docs.telaven.com/get-started/errors.md) page.

## Staying under it

* **Batch numbers.** One [Send SMS](https://docs.telaven.com/api-reference/sms/send-sms.md) call takes up to 1,000 numbers and counts as one request.
* **Use campaigns for big sends.** [Create](https://docs.telaven.com/api-reference/sms-campaigns/create-campaign.md) and [send a campaign](https://docs.telaven.com/api-reference/sms-campaigns/send-campaign.md) to reach a whole list in two calls; Messaly paces the sending.
* **Use webhooks, not polling,** for delivery reports and replies. See [Webhooks](https://docs.telaven.com/guides/webhooks.md).
* **Use one key per system**, so each gets its own allowance.

## Other limits

| Limit | Value |
| - | - |
| Numbers per Send SMS call | 1,000 |
| SMS message length | 1,600 characters. Over 160 GSM or 70 Unicode characters is sent in parts. |
| Page size | Up to 100 (200 for campaign recipients) |
| WhatsApp campaign upload | Up to 10,000 recipients |
| Webhook response time | 10 seconds, then the delivery is retried |


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