Skip to content

rate_limited

HTTP 429. The key exceeded the rate limit for this endpoint’s cost tier. Limits are per API key, not per IP, and heavier routes sit in stricter tiers.

What to do: Wait the number of seconds in Retry-After, then retry - detail names the tier and the same delay. RateLimit-Remaining and RateLimit-Reset ride on every response, so you can slow down before hitting this. See Rate limits.

Every error is an RFC 9457 problem document - match on code (stable forever), show detail to humans, and quote instance when reporting an occurrence to support.