Throttles

Every call is throttled in some way. The tables below lay out throttling levels and limits as well as headers returned in the response.

Throttling LevelCalls per Minute
Very Light200
Light20
Moderate10
Heavy5
Severe1

Throttling Headers

The below headers will be returned along with a status code of 429 when throttling has been activated. These headers should be used to accurately determine how often a call should be made. Using these headers will prevent needlessly calling the api before the throttling limit has been lifted.

HeaderDescription
X-RateLimit-LimitThe maximum number of calls that can be made per minute.
X-RateLimit-RemainingThe number of calls that are remining within the per minute limit
X-RateLimit-ResetThe time to wait before the rate limit is reset and calls can be made again. This is in milliseconds.

What’s Next