← All errors

Error

RATE_LIMITED

Rate limit exceeded

HTTP status
429
Retryable
Yes — unchanged
Returned by
11 operations

What to do

Wait for the interval in retry_after_seconds, then retry.

What it looks like

{
  "code": "RATE_LIMITED",
  "detail": "A sentence describing this particular failure.",
  "field_errors": [],
  "instance": "/api/public/v1/...",
  "next_action": "Wait for the interval in retry_after_seconds, then retry.",
  "request_id": "req_9f2c1b7ae4d84c6f9b2e10a3",
  "retry_after_seconds": 30,
  "retryable": true,
  "status": 429,
  "title": "Rate limit exceeded",
  "type": "https://swisstouristy.com/developers/errors/rate_limited"
}

code is the stable contract. detail is prose for a human reading a log and may be reworded at any time — do not parse it, and do not branch on status alone, since several codes share one.

Operations that return it