Rate Limits
(draft, this is not live yet, please shout if this isn’t going to work for you or you see other problems)
There are limits per day (reset at midnight UTC) and per rolling 15 minute window. The following http headers are returned on each request:
X-RateLimit-Limit: <15m limit>,<daily limit>
X-RateLimit-Remaining: <15m limit remaining>,<daily limit remaining>
Over rate limit requests receive a 429 status code and a Retry-After http header indicating how many seconds need to elapse until the call might succeed.
Retry-After: 370
There is an additional limit of 10 calls per second per IP address. This limit does not return any rate limit related http headers.
Rate limits are enforced differently for API key callers and OAuth client apps.
OAuth Client Apps
The default daily rate limit is 100/user per day up to 500 users (max 50000 requests), with a minimum of 5000. The daily limit resets at midnight UTC.
The requests per 15 minute limit is 1/8 of the daily limit with a minimum of 2500. This is a rolling limit and does not reset at specific intervals.
If you have more than 500 users and need a higher daily limit, or a lower limit for safety, contact [email protected]. The limits are to protect the Intervals.icu infrastructure from apps with many users suddenly generating many more calls than usual.
Current limits and API usage information can be found on the oauth client management page (look for “Manage App” on your app on /settings/apps).
API Key Callers
API key calls are limited to 5000 requests per day and 2500 requests per rolling 15 minute window. If you need more than that you need to create an app using OAuth.