HTTP 429 Status Code
When a request exceeds the rate limit, the API will return an HTTP 429 status code to the client. The body of the response will be a JSON object with the following format:Rate Limit Headers
When a request exceeds the rate limit, the API will also return one header indicating the time until the next call can be made:X-Rate-Limited-For
: The number of seconds until the next API call will succeed.
X-Rate-Limited-For
header before making another API call.
Example
Here is an example response when a client exceeds the rate limit:X-Rate-Limited-For
header indicates that the client should wait for 5 seconds before making another API call that will succeed. The response body is a JSON object indicating that the rate limit has been exceeded.