Rate Limits
The Novant API includes several limits based on plan size and rate of requests.
Daily Usage Limit
Each project has a daily request limit based on plan size.
The current limit is 2
requests per capacity unit.
For example:
Plan | Capacity | Daily Limit |
---|---|---|
Starter Bundle | 4000 caps | 8000 requests/day |
Pro 10K Plan | 10,000 caps | 20,000 requests/day |
Pro 50K Plan | 50,000 caps | 100,000 requests/day |
Once your daily request limit has been reached, future requests for
that day will return 429
error responses until the window
is reset the following day.
Per Key Limits
By default, all keys may consume up to the project-wide daily request limit. Project owners may optionally set a daily limit on a per-key basis under the API Keys tab on the project.
If a per-key limit is set, the once your daily request limit has been reached for that key, future requests for that day will return 429 error responses until the window is reset the following day.
Rate Limiter
The rate limiter safeguards against bursts of incoming traffic to
help maximize stability. If you send many requests in quick succession,
you might see error responses with status code 429
.
The current limit is 1000
requests within a 5-minute
sliding window.
A basic technique for integrations to gracefully handle limiting is
to watch for 429
status codes and build in a retry
mechanism. The retry mechanism should follow an exponential backoff
schedule to reduce request volume when necessary. We’d also recommend
building some randomness into the backoff schedule to avoid a thundering
herd effect.