All Assignr requests, including API requests, are subject to rate limits, in an effort to ensure that your use of our API does not negatively impact other users of the system.
The following rate limit rules apply:
- Maximum of 180 requests per minute
- Maximum of 500 requests per 5 minute interval
- Maximum of 5000 requests per hour
You can check the returned HTTP headers for any request to see your current rate limit status:
HTTP/1.1 200 OK
Date: Thu, 23 Mar 2017 20:47:25 GMT
X-Ratelimit-Limit: 180
X-Ratelimit-Period: 60
X-Ratelimit-Remaining: 178
X-Ratelimit-Reset: 1490302080
X-Ratelimit-Reset-Seconds-Remaining: 35
assignr.com will return information about the rule with the least number of requests left before your request will be blocked.
The rate limit rule can be found in X-Ratelimit-Limit and X-Ratelimit-Period headers. In this example, the rate limit rule is 180 requests in 60 seconds.
X-Ratelimit-Remaining indicates how many requests are remaining before your request will be blocked.
X-Ratelimit-Reset is the time (in UTC Epoch time) at which the current rate limit window will reset
X-Ratelimit-Reset-Seconds-Remaining is the number of seconds until the current rate limit window resets.
If you exceed a rate limit, assignr.com will return a 429 Too Many Requests HTTP error code
HTTP/1.1 429 Too Many Requests
Date: Thu, 23 Mar 2017 20:47:25 GMT
X-Ratelimit-Limit: 180
X-Ratelimit-Period: 60
X-Ratelimit-Remaining: 0
X-Ratelimit-Reset: 1490302080
X-Ratelimit-Reset-Seconds-Remaining: 35