Skip to content
Search documentation/

Rate limit exceeded

rate_limitedHTTP 429Retry after a wait

What happened

Too many requests arrived too quickly, so this one was refused before it ran.

What to do next

Wait for Retry-After, then repeat the request with the same Idempotency-Key and body.

Can you retry?

Retry after a wait. Repeat the identical request after the Retry-After delay, or after a short wait when none is given, with the same Idempotency-Key and body. retry: after_delay

Who acts

You: the software that sent the request. who_acts: caller

Don't

  • Don't retry with a new Idempotency-Key; a new key is a new request. change_idempotency_key

Example response

Sent as application/problem+json. The detail describes the particular request; keep request_id for support.

{
  "type": "https://docs.perionpayments.com/problems/rate-limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limited",
  "detail": "Too many requests arrived too quickly, so this one was refused before it ran.",
  "request_id": "req_8YkQ2rL0ZtW4",
  "retryable": true,
  "retry": "after_delay",
  "who_acts": "caller",
  "next_step": "Wait for Retry-After, then repeat the request with the same Idempotency-Key and body.",
  "do_not": [
    "change_idempotency_key"
  ]
}

All problem codes · Reading problem responses