Rate limits and versions
Rate limits
| Budget | Limit |
|---|---|
| All calls of a key | 600 requests per minute |
| Applications sent with a key | 60 per minute |
| Additions to a list with a key | 10 per minute |
| Requests answered 401 for the same IP address | 30 per minute |
Each Nova server counts on its own, so take the limits as the most you should send, not as an exact allowance.
Answers to authenticated requests carry the state of the most specific limit the call counts against:
RateLimit-Limit: 600
RateLimit-Remaining: 598
RateLimit-Reset: 42RateLimit-Limit: requests allowed in the window.RateLimit-Remaining: requests left in the window.RateLimit-Reset: seconds until the window resets.
When you go over, the call is answered 429 rate_limited with a Retry-After header in seconds. Wait that long before you try again.
Versions
The version is the first segment of the path: /v1. New calls and new fields can be added to a version. Each change is listed in the changelog.