Rate limit reached indication


On this page Rate limits there is a description how rate limit is indicated via HTTP status code and response headers, however there are some questions related:

  1. Per second limit β†’ 429 You have reached the maximum per-second rate limit for this API. Try again later.

Example response header:
X-RateLimit-Category: Light
X-RateLimit-Type: QPS

  • After how many times to repeat the API request ?
  • Is there a header (Retry-After) indicating when the next API request can be sent ? If yes, what is the time format ?
  1. Daily limit β†’ 429 You have reached the maximum daily rate limit for this API. Refer to the response header for details on when you can make another request.

Example response header:
X-RateLimit-Category: Heavy
X-RateLimit-Type: Daily-limit
X-RateLimit-Limit: 30000
X-RateLimit-Remaining: 0
Retry-After: 2020-05-31T00:00:00Z

  • the Retry-After header contains the date when the next API request can be sent. Is this correct ? Is the date format correct ?

Generally: all the http headers listed above are included in the http response according to the actual case ?

Thank you.

Hi @ZPForum
Thanks for reaching out to us, I am happy to help here.
For your first question, we do not have a header that indicates when the request can be sent again.
But it depends on the endpoint you are calling and the plan that you have

For the second question, yes that time and date format is correct.
If you reach a Daily limit, you won’t be able to call that endpoint again until next day at 00:00:00 UTC

Thank you for the response.

1 Like