Rate limits and versions

Rate limits

BudgetLimit
All calls of a key600 requests per minute
Applications sent with a key60 per minute
Additions to a list with a key10 per minute
Requests answered 401 for the same IP address30 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: 42
  • RateLimit-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.