Usage and Rate Limits

Rate limit refers to the number of API calls one can make in Central per day.

The number of API calls per day is dynamic and is based on the number of subscribed devices in the account. By default, the value is set to 5000 API calls per day.

📘
Note
The Rate Limit resets at GMT midnight.

The table below illustrates important values relevant to the usage and rate limits of the API calls. These values can be found in the HTTP Response Headers for all API calls.

Header Parameter	Description
X-RateLimit-Limit-day	API rate limit for a day E.g. if the value is 5000, then one can make 5000 API calls per day
X-RateLimit-Remaining-day	Remaining number of API calls that can be made during a day E.g. a value of 990 means one can make 990 more API calls before hitting the rate limit
Date	Date & Time of API call in GMT E.g. Fri, 23 Apr 2021 21:21:54 GMT
X-Request-Start	Date & Time of API call in Unix time/Epoch Time E.g. t=1619212914.071.
X-RateLimit-Limit-second	API rate limit per second E.g. 7 API calls can be made per second
X-RateLimit-Remaining-second	Remaining number of API calls that can be made in one second as per the rate limit for one second

This is an example of HTTP Response Headers for an API call where you can find usage and rate limit values.

{
  "access-control-allow-origin": "*",
  "cache-control": "no-cache, no-store, must-revalidate, private",
  "connection": "keep-alive",
  "content-encoding": "gzip",
  "content-type": "application/json",
  "date": "Fri, 21 Jan 2022 18:50:27 GMT",
  "pragma": "no-cache",
  "transfer-encoding": "chunked",
  "vary": "Accept-Encoding",
  "via": "kong/0.14.1",
  "x-frame-options": "SAMEORIGIN",
  "x-kong-proxy-latency": "3",
  "x-kong-upstream-latency": "146",
  "x-ratelimit-limit-day": "1000",
  "x-ratelimit-limit-second": "7",
  "x-ratelimit-remaining-day": "998",
  "x-ratelimit-remaining-second": "6",
  "x-request-start": "t=1642791027.187",
  "x-xss-protection": "1; mode=block"
}

📘Note

📘
Note