HomeGuidesAPI Reference
GuidesAPI ReferenceGitHubAirheads Developer CommunityLog In

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

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 ParameterDescription
X-RateLimit-Limit-dayAPI rate limit for a day

E.g. if the value is 5000, then users from an account can make 5000 API calls per day in total
X-RateLimit-Remaining-dayRemaining 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
DateDate & Time of API call in GMT

E.g. Fri, 23 Apr 2021 21:21:54 GMT
X-Request-StartDate & Time of API call in Unix time/Epoch Time

E.g. t=1619212914.071.
X-RateLimit-Limit-secondAPI rate limit per second

E.g. 7 API calls in total can be made per second from the account
X-RateLimit-Remaining-secondRemaining 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"
}