Rate Limit error codes
Every public API error code emitted by Rate Limit, with its HTTP status, its type and a page per code.
Error codes emitted by Rate Limit. Each code links to its own page with the cause and the action to take.
| Code | Type | HTTP | Description |
|---|---|---|---|
account_probation_limit_exceeded | rate_limit_error | 429 | The company is inside its NEW-ACCOUNT PROBATION window, and the ceiling that rejected this call comes from the ACCOUNT'S AGE, not from its plan. A freshly created account starts with a reduced allowance that widens on its own as the account matures. |
company_monthly_quota_exceeded | rate_limit_error | 429 | The company used up the monthly volume its plan grants to all of its keys together. |
company_rate_limit_exceeded | rate_limit_error | 429 | The company exceeded the per-minute rate its plan grants to all of its keys together, not the rate of a single key. |
email_delivery_circuit_open | rate_limit_error | 429 | Email sending is temporarily CUT, either by a provider incident or by a delivery problem of this company. It is not a quota: it is a safety cut so sending reputation is not burnt further while delivery keeps failing. |
email_recipient_budget_exceeded | rate_limit_error | 429 | The company ran out of DISTINCT RECIPIENT budget for the window. This is not a request limit: it counts mailboxes reached, so neither splitting the send across more calls nor using another credential changes anything. |
monthly_quota_exceeded | rate_limit_error | 429 | The company exhausted the monthly call quota its plan includes. |
pdf_generation_budget_exceeded | rate_limit_error | 429 | The hourly budget of PDF RENDER WORK is exhausted. This is not a request limit: it counts renders against the Chrome pool shared by every tenant, so neither spreading the calls nor using another credential changes anything. The subcode says which of the two budgets ran out — company_budget (the whole company) or document_budget (this single document, while the rest keep generating). |
portfolio_monthly_quota_exceeded | rate_limit_error | 429 | The portfolio MONTHLY quota is exhausted. It is counted over the managing company and its active children together, so one child's consumption exhausts everyone's. |
portfolio_rate_limit_exceeded | rate_limit_error | 429 | The per-minute ceiling you hit belongs to the PORTFOLIO — the managing company plus all its active child companies together — not to this credential nor to this company. That is why neither spreading traffic across credentials nor onboarding another child company changes anything: both keep counting in the same bucket. |
rate_limit_exceeded | rate_limit_error | 429 | The key sent more requests than its rate allows in the current window. |
upload_in_flight_budget_exceeded | rate_limit_error | 429 | The company has too many bytes crossing the temporary disk at once (tabular imports and their previews, UBL, OCR and backup restore). This is a budget of bytes IN FLIGHT, not of stored space: it consumes no request bucket and does not appear in the rate-limit headers. |
Related
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.