API · problem · HTTP 503
Ceiling reached
This page is what the type field of the error points at. Every answer this API refuses carries one, and it is a stable address rather than a version of the docs.
The refusalbudget-exceeded
- When it happens
- A per-caller or service-wide ceiling was reached. The ceilings exist because a public endpoint spends unattended; they are stated on the pricing page.
- What to do
- Wait for the window to roll — Retry-After says how long — or take the open tier from the published files, which have no ceiling at all.
The shape of the answerRFC 9457
Problem details: type, title, status and detail, plus whatever the individual failure can usefully add. The detail is written for the person reading the log, and names the parameter or the id that caused it.
| type | This page’s address. Stable. |
|---|---|
| title | Ceiling reached |
| status | 503 |
| detail | What went wrong, in this request. |
The full list of failures, with the schema, is in the API documentation.