API referenceDraft
Rate limits
How limits work and how to read them from responses.
Draft
The hosted API is a planned service with a draft specification. The local API described alongside it already exists and runs on your own machine.
In the hosted design, limits apply per IP address, account, API key, endpoint and device, and depend on the plan. Their values have not been set.
| Plan | Rate limits |
|---|---|
| Free | Pending. Not published yet |
| Premium | Pending. Not published yet |
| Developer | Pending. Not published yet |
| API | Pending. Not published yet |
Response headers
| Header | Meaning |
|---|---|
x-ratelimit-limit-requests | Requests allowed in the current window. |
x-ratelimit-remaining-requests | Requests left in the current window. |
x-ratelimit-reset-requests | Seconds until the request window resets. |
x-ratelimit-remaining-tokens | Tokens left in the current window. |
retry-after | Sent with 429 responses: seconds to wait before retrying. |