RATE_LIMITED

429rate_limit

You have exceeded the allowed request rate.

Cause

Too many requests in the current window.

How to fix it

Back off and retry after the retry_after seconds (also on the Retry-After header). Add jitter to avoid thundering-herd retries.

Example response

429 RATE_LIMITED

JSON

{
  "error_code": "RATE_LIMITED",
  "error_type": "rate_limit",
  "error_message": "You have exceeded the allowed request rate.",
  "hint": "Back off and retry after the retry_after seconds (also on the Retry-After header). Add jitter to avoid thundering-herd retries.",
  "docs_url": "https://docs.billerapi.com/errors/RATE_LIMITED",
  "request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34",
  "retry_after": 30
}

Error handling — the error envelope shape and how to parse it
Error code reference — every stable error code

Canonical docs URL: https://docs.billerapi.com/errors/RATE_LIMITED

Was this page helpful?

RATE_LIMITED

Cause

How to fix it

Example response

429 RATE_LIMITED

Related