rate_limit_exceeded

HTTP 429 · Too many requests for this API key.

What causes it

The per-minute or per-day limit on your key was exceeded. Limits are per key, not per client and not per IP.

What to do

Back off exponentially with jitter and retry. If you hit it consistently, you are probably polling too broadly — or you need a higher limit on the key.

Retry?

Yes — exponential backoff with jitter.

The response

{
  "type": "https://developers.vaki.co/errors/rate_limit_exceeded",
  "title": "…",
  "status": 429,
  "code": "rate_limit_exceeded",
  "detail": "…",
  "instance": "/v1/checkout_links"
}

Branch on code, never on title or detail. The full list of codes, and the shape of the problem document, is on Errors.