rate_limit_exceeded — key request rate exceeded
429rate_limit_exceededRetry-After present
What happened
The request was not performed. The body has reason: "rate_limit_exceeded" (the same code in error_code) and retry_after in seconds; the headers carry Retry-After and X-RateLimit-*.
Why
The key exceeded one of its request-rate windows limits.requests.per_minute / per_hour / per_day. Requests are counted, not work volume: a light and a heavy request weigh the same. By default a key has no request-rate limit — the windows are set in the key settings.
What to do right now
Wait retry_after seconds and retry. If you hit it constantly, lower the rate: replace order status polling with realtime events, and pause between catalog pages.
Which request to send next
The same request after retry_after seconds. The key's active windows are visible in the developer dashboard.
Where to go next
Feed this page to an AI
spec 1.0.0