# Rate limits

> How many requests you can send, and the headers that tell you where you stand.

Requests are counted per API key in one-minute windows. When you go over the limit, the API returns `429` until the window resets.

## Limits

| Requests | Limit per minute |
| --- | --- |
| Create and list payments, and everything under `/refunds` | 120 |
| Everything else | 240 |

## Headers

Every response tells you where you stand:

| 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, in Unix seconds. |
| `Retry-After` | Only on `429`: seconds to wait. |

**429 Too Many Requests**

```json
{
  "detail": "Rate limit exceeded"
}
```

On a `429`, wait for `Retry-After` and send the request again with the same `Idempotency-Key`.
