Concepts
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. |
{
"detail": "Rate limit exceeded"
}On a 429, wait for Retry-After and send the request again with the same Idempotency-Key.