Limits and quotas
Each plan has credits per month and request limits per minute, per hour and per day, counted per organization.
Reading the plans…
Over a limit
A request over a request limit gets 429, at no charge. The answer's body carries retryAfter, the seconds to wait; the 429 has no Retry-After header. A limit per day resets at midnight UTC.
When the plan's credits for the month run out, extractions use purchased credits; with no balance, the answer is 402 NOT_ENOUGH_CREDITS and nothing runs.
The X-Quota headers
When the plan's credits for the month pass 80%, the extraction's 201 and 422 answers carry these headers:
| Header | What it says |
|---|---|
X-Quota-Warning | low from 80% of the plan's credits for the month; high from 90%. |
X-Quota-Limit | The plan's credits per month. |
X-Quota-Used | The plan's credits used this month. |
X-Quota-Remaining | The plan's credits left this month. |
X-Quota-Percent | The share used, with one decimal. |
Below 80%, they are not sent. A browser can read them on a call from another domain.