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

# Rate limits

> How the gateway signals rate limiting and how to back off.

The gateway rate-limits requests at the edge. When you exceed the limit, it
returns `429` with a `Retry-After` header.

## What you get back

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 2
Content-Type: application/problem+json
```

```json theme={null}
{
  "type": "https://errors.zeam.app/rate-limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded.",
  "requestId": "01J…"
}
```

## How to handle it

* Read the `Retry-After` header (seconds) and wait that long before retrying.
* Use exponential backoff with jitter for repeated `429`s.
* Cache your [access token](/authentication/tokens) and reuse it until close to
  expiry rather than re-issuing on every call.

<Info>
  Specific rate limits are not yet published.
</Info>