The API imposes a rate limiting constraint. Exceeding that limit results in a 429 error response. Consider this
especially when calling successive operations as part of a loop.

Responses contain these headers to specify rate limit

  • X-RateLimit-Limit. The maximum number of tokens allowed.

  • X-RateLimit-Remaining. The number of tokens remaining.

  • X-RateLimit-Next. An ISO 8601 timestamp that indicates when you can next make a request.

Once X-RateLimit-Remaining becomes 0, you get a 429 error the next time you make an API call. The response header contains X-RateLimit-Next, indicating when you can next make a request.

If you don't make any more API calls after you receive a 429 error, the X-RateLimit-Remaining gradually increases and becomes equal to X-RateLimit-Limit.