What Are Recurly's API Rate Limits?

To provide a fast response time to all of our customers, Recurly may rate-limit excessive API requests. By default, new Recurly sites have the following API rate limits:

• Sandbox sites: 400 requests per minute. All requests count toward the rate limit.

• Production sites: 1,000 requests per minute. Only GET requests count toward the rate limit.

Once your site moves into production mode, Recurly will only rate-limit GET requests. New subscriptions, account modifications, and other requests using POST, PUT, or DELETE methods will not count against your rate limit.

How the Rate Limit Is Calculated The rate limit is calculated over a sliding 5-minute window. This means a production site could make 4,000 requests within one minute and not hit the rate limit as long as the site made less than 1,000 requests during the prior 4 minutes. If an API request exceeds the rate limit, the API will return a 429 Too Many Requests HTTP status.

Monitoring Your Rate Limit The rate limit applied to your client can be determined with the X-RateLimit-Limit header. The number of remaining requests is sent in the X-RateLimit-Remaining header. Finally, the X-RateLimit-Reset header contains an integer value representing the time, measured in seconds since the UNIX Epoch, at which the request count will be reset.

If you are planning a large data import or a heavy period of testing, please contact support to request a temporary rate limit increase.