API referenceError code index503usage_check_unavailable

usage_check_unavailable

The message text is shown in the example below.

HTTP status503
typeservice_unavailable_error
Retry?Yes, with back-off after Retry-After
StatusIn the public catalog (error-envelope.ts)
Extra fieldslimit, resets_at, retry_after

When it happens

Your usage could not be checked, so the request was not run.

Example

{
  "error": {
    "type": "service_unavailable_error",
    "code": "usage_check_unavailable",
    "message": "Usage can't be verified right now. Please retry in a moment.",
    "param": null,
    "request_id": "req_6f1c2a9e0b7d4c3a8e5f1b2d",
    "limit": "unavailable",
    "resets_at": null,
    "retry_after": 5
  }
}

How to fix it

  • Retry after 5 seconds.

Detect it in code

err = resp.json().get("error", {})
if resp.status_code == 503 and err.get("code") == "usage_check_unavailable":
    delay = err.get("retry_after") or 2
    time.sleep(delay)  # then retry
Was this page helpful?