{"article":{"id":360034160731,"url":"https://recurly.zendesk.com/api/v2/help_center/en-us/articles/360034160731.json","html_url":"https://support.recurly.com/hc/en-us/articles/360034160731-What-Are-Recurly-s-API-Rate-Limits","author_id":414910819471,"comments_disabled":false,"draft":false,"promoted":false,"position":0,"vote_sum":1,"vote_count":1,"upvote_count":1,"downvote_count":0,"section_id":40749416897684,"created_at":"2019-09-23T18:34:17Z","updated_at":"2025-08-30T05:32:19Z","name":"What Are Recurly's API Rate Limits?","title":"What Are Recurly's API Rate Limits?","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2025-08-13T21:20:53Z","user_segment_id":null,"permission_group_id":2613252,"content_tag_ids":[],"label_names":[],"body":"<div class=\"sc-iBPRYJ ibEZuy\">\n<div class=\"sc-hKgILt ebSxEx\">\n<p>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:</p>\n<ul>\n<li>\n<p><strong>Sandbox sites:</strong> 400 requests per minute. All requests count toward the rate limit.</p>\n</li>\n<li>\n<p><strong>Production sites:</strong> 1,000 requests per minute. Only <code>GET</code> requests count toward the rate limit.</p>\n</li>\n</ul>\n<p>Once your site moves into production mode, Recurly will only rate-limit <code>GET</code> requests. New subscriptions, account modifications, and other requests using <code>POST</code>, <code>PUT</code>, or <code>DELETE</code> methods will not count against your rate limit.</p>\n<p><strong>How the Rate Limit Is Calculated</strong> 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 <strong><code>429 Too Many Requests</code></strong> HTTP status.</p>\n<p><strong>Monitoring Your Rate Limit</strong> The rate limit applied to your client can be determined with the <code>X-RateLimit-Limit</code> header. The number of remaining requests is sent in the <code>X-RateLimit-Remaining</code> header. Finally, the <code>X-RateLimit-Reset</code> header contains an integer value representing the time, measured in seconds since the UNIX Epoch, at which the request count will be reset.</p>\n<p>If you are planning a large data import or a heavy period of testing, please contact support to request a temporary rate limit increase.</p>\n</div>\n</div>","user_segment_ids":[]}}