API

rate_limited

HTTP 429. Rate limited

What it means

A rate limit tier is used up.

What to do

Wait retry_after seconds (the Retry-After header says the same). Read the RateLimit-* headers to see how much is left before you hit the wall. See rate limits.

Retrying

Retry after the delay in Retry-After (or retry_after).

Extra members

retry_after: Seconds until the window resets.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "detail": "Rate limit of 60 requests per 60 seconds for the \"read\" tier exceeded. Retry in 12 seconds.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "rate_limited",
  "request_id": "req_c4v8n2m6x1z3",
  "retry_after": 12
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.