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

# Rate limits

> The current organization-level sliding-window limit, response headers, and retry behavior.

The Messaging API enforces each organization's configured request limit over a
one-minute window. The limit is organization-wide, not a published per-endpoint
table.

For example, a successful counted request can include:

```http theme={null}
X-RateLimit-Limit: <organization limit>
X-RateLimit-Remaining: <remaining requests>
```

A rejected request includes the applicable wait time:

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: <seconds>
```

```json theme={null}
{ "error": "rate limit exceeded: <organization limit> requests per minute" }
```

The exact configured number depends on the organization and active
entitlements. Responses do not include an `X-RateLimit-Reset` header.

## Retry behavior

Honor `Retry-After`, then retry with jitter. Do not immediately fan out retries
from concurrent processes.

WhatsApp or Meta may apply their own limits after a request passes Polymorfa's
middleware. Those errors use the endpoint's documented native or
Meta-compatible envelope.