Rate limits
LIGR applies fair-use limits to the REST API. LIGR does not publish a fixed request budget. LIGR counts each request with a valid API key against the organization that owns the key. All keys of one organization share one budget, so a new key does not add budget. A request without a valid API key counts against its client IP address. Read the headers on every response, and slow down before they reach zero.
Headers
Section titled “Headers”Every response carries the IETF draft headers.
RateLimit-Limit: 24000RateLimit-Remaining: 23987RateLimit-Reset: 2041RateLimit-Policy: 24000;w=3600| Header | Meaning |
|---|---|
RateLimit-Limit | The number of requests the current window allows |
RateLimit-Remaining | The number of requests left in the current window |
RateLimit-Reset | The number of seconds until the current window resets |
RateLimit-Policy | The window that the other headers describe, as <limit>;w=<seconds> |
The headers describe the budget of the request: the organization of the API key, or the client IP address. Three windows apply at the same time: one second, one minute and one hour. On a successful response, the headers describe the one-hour window. On a 429, they describe the window that refused the request. Keep bursts short, because the headers do not show the shorter windows.
Observe mode
Section titled “Observe mode”Production does not enforce the limits today. While enforcement is off, an over-limit request
still succeeds.
The response carries x-ligr-rate-limit-observe: 1.
Enforcement
Section titled “Enforcement”Enforcement starts on a date to be announced in the changelog. Until then, treat
x-ligr-rate-limit-observe: 1 as a 429.
Over the limit
Section titled “Over the limit”An enforced over-limit request returns 429. The body names the budget that refused the request.
| Request | Budget | 429 body |
|---|---|---|
| With a valid API key | The organization of the key | { "message": "Organization has made too many requests" } |
| Without a valid API key | The client IP address | { "message": "Client IP address has made too many requests" } |
Wait RateLimit-Reset seconds, then retry.