Skip to main content

Rate Limiting

All Bold APIs are rate-limited to protect merchants from a degraded experience.

The rate limit is approximately 10 requests per second, per service, per user. For example, one user can make approximately 10 requests per second to Bold Checkout, Bold Subscriptions, and Bold Price Rules concurrently.


The rate of API responsiveness is not guaranteed and may be affected by other factors, including the complexity of the request made, total volume of requests, or network traffic.

When a user exceeds the rate limit, the API responds with an error. The HTTP status of the error is 429 Too Many Requests, and the response body appears as follows:

"message": "API rate limit exceeded"

Handling and preventing rate limit errors

If you experience a rate limit error, the best course of action is to wait one second and retry the request.

You can implement several software development best practices to prevent rate limit errors from happening in the first place:

  • Optimize code to limit the number of API calls.
  • Check the HTTP status codes of each response.
  • Implement a delayed retry for calls that fail.
  • Use webhooks where available (such as Bold Subscriptions webhooks) to be notified of changes instead of polling the API for updates.