Rate Limit Policy

Updated 5 September 2016

Our rate limiting policy is a per-access token limit.

The access token rate limit applies on a per-second basis: each access token is permitted 100 requests to a nation every 10 seconds.

You can gather realtime information about the rate limit by examining the headers we provide in API HTTP responses:

Access token headers

  • X-RateLimit-Limit - the length of the rate limiting interval, usually 10 seconds
  • X-RateLimit-Remaining - the remaining number of requests in the rate limiting interval
  • X-RateLimit-Reset - the date that the rate limit interval resets, expressed in epoch time

Example

X-RateLimit-Limit: 10s
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 1377043200

Please contact NationBuilder API Support at api@nationbuilder.com for more information.

Showing 3 reactions

Wrap code snippets in <code></code> tags.
Please check your e-mail for a link to activate your account.