← Error catalogue

429 Too Many Requests

You have exceeded the rate limit for your key.

Machine code: rate_limited

Each key has a fixed per-minute budget; this request was over it.

How to resolve

Back off until the window resets. The RateLimit-Reset and Retry-After response headers say how many seconds to wait, and GET /v1/meta/status reports your current budget.

Response shape

Every error is an RFC 9457 application/problem+json document with a machine code and a trace_id you can quote to support.

{
  "type": "https://docs.openiris.io/errors/429",
  "title": "Too Many Requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "Rate limit exceeded.",
  "instance": "/v1/charges",
  "trace_id": "0HMVABCDEF123"
}