Skip to main content

Rate Limits on the Airthings API

Airthings for Business#

Each Airthings For Business Client is by default allowed 5000 requests per hour. Users signed in through the same client all share that same quota. Since the client and subscription is owned by the user administrating it.

The current rate limit status is indicated in the response headers:

X-RateLimit-Reset: 1607336100 // The time at which the current rate limit window resets (UTC epoch seconds).
X-RateLimit-Remaining: 1000 // The number of remaining requests in the current rate limit window.
X-RateLimit-Limit: 5000 // The maximum number of requests you're granted per hour.

If a client exceeds the rate limit, the API will respond with status code: 429 and the below mentioned response body and header indicating when the sliding windows will grant the client a new request.

X-RateLimit-Retry-After: 100 // A new request can be performed after this many seconds.
"error_description": "Rate limit on API exceeded"

You can request increases to the API quota:

Airthings For Business Support

Airthings Consumer#

A consumer can create 1 Airthings API-client, with Client Credentials Grant authorization. The client can be used to fetch air quality data uploaded by the customer's own device. The API is limited to 120 requests per hour.

Last updated on by david