What are the Chargebee API limits?
Scope
Chargebee API limits
What happens when I reach the API limit?
Solution
There are no additional charges to use Chargebee's APIs. However, to ensure optimal app performance, we regulate the API limits for TEST and LIVE sites as listed below.
The default limits for live sites are defined as follows:
| Plan | Default limit (per minute) |
|---|---|
| Starter | 150 |
| Performance | 1000 |
| Enterprise (default) | 3500 |
| Enterprise (custom) | No upper limit |
Note
- While these API limits are the default settings, you can easily request higher limits by contacting Chargebee Support with your requirements.
- For customers with requirements that exceed the Enterprise (default) plan's API limits, our solution experts work closely with you to ensure that API limits are not only well-provisioned but also fully capable of scaling to meet your most demanding traffic and burst needs. Chargebee is built to support your growth, and we are committed to providing the flexibility and capacity your business requires.
For test sites, it is 150 API calls per minute.
API Rate Limits
Chargebee restricts API requests when you exceed the limits entitled for your plan. The limiting mechanism is employed considering two criteria:
-
Requests per minute - Number of requests in the past 60 seconds.
-
Concurrent requests - Number of requests at any given instant of time.
When the upper limit is breached on either of the above criteria, an HTTP 429 error response is returned for subsequent requests. As a result, no more requests are served until the limit resets (in approximately a minute).
What happens when you exceed the limit
- For TEST sites, on exceeding the limit, all requests will be blocked. The block will be removed automatically once the requests fall within the limits.
- For LIVE sites, on exceeding this limit:
- Your account will be flagged.
- You will be notified by email (Owner, Admin, and Emergency contact).
- If we do not receive an acknowledgement, all GET requests will be blocked, and POST requests will not be accepted until we see fit.
- The block will be removed after requests are throttled within the specified limits.
If you have a scheduled activity and need a temporary API limit increase, or are looking to increase your default API limit, you can reach out to Chargebee support.
Note
Chargebee currently does not offer a site-wide API call log or breakdown. To approximate this, you can use the List Events API filtered by source=api to retrieve events triggered via API, or browse them under Logs > Events > Source > Is > API in the Chargebee dashboard.
Was this article helpful?