Docs
Search the docs
Find a page in the docs

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

RequestsLimit per minute
Create and list payments, and everything under /refunds 120
Everything else240

Headers

Every response tells you where you stand:

HeaderMeaning
X-RateLimit-LimitRequests allowed in the window.
X-RateLimit-RemainingRequests left in the window.
X-RateLimit-ResetWhen the window resets, in Unix seconds.
Retry-AfterOnly on 429: seconds to wait.
429 Too Many Requests
{
  "detail": "Rate limit exceeded"
}

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