The AirSaas API has quotas in place to make sure its usage is fair and to avoid abuses.

How it works

The current system works with 3 throttle rates corresponding to 3 sliding time windows:

15 calls per second
500 calls per minute
100 000 calls per day

All API calls (GET, POST, etc) are subject to those rates, and they apply per API key. All 3 rates apply at the same time, and if at least one of them is exceeded, you will receive a 429 response.

For ex if you continuously make 10 calls per second, you will pass through the 15 calls per second rate, but after 50 seconds, you will be blocked for 10 seconds until the sliding 500 calls per second rate is over.

429 responses

If you make more calls than any allowed throttle rate, you will receive a 429 response.

The response will contain a readable message:

{
    "detail": "Request slowed down. Expected available in 3 seconds."
}

And a specific header that can be used programmatically: Retry-After with the number of seconds you need to wait for. Ex: Retry-After: 3