rate_limited

HTTP 429rate_limitedRate limited

You exceeded the current rate limit (burst) for the key.

Common causes

• parallel requests above the plan limit
• a loop without a delay

What to do

• Wait Retry-After seconds; use exponential backoff with jitter.

Retry?	Yes, with exponential backoff (honour Retry-After).
Billing	0 units.
type	https://maticna.si/docs/errors/rate_limited

Example response

HTTP/1.1 429
Content-Type: application/problem+json
Retry-After: <seconds>
X-Request-Id: req_01JB2Q8X6S7T

{
  "type": "https://maticna.si/docs/errors/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "detail": "You exceeded the current rate limit (burst) for the key.",
  "instance": "/v1/entities/12345679",
  "code": "rate_limited",
  "request_id": "req_01JB2Q8X6S7T"
}

Other errors with status 429

• quota_exceeded · Quota exceeded
• natural_person_cap_exceeded · Daily natural-person lookup cap exceeded

All errors