Rate limiting

Bearer uses rate limits to keep the infrastructure safe. The limits vary depending on the plan you've subscribed to, but are always counted on the same window of 60 seconds.

Rate Limits

Every API requests performed through Bearer, using our API client (or not), are rate limited according to the following:

Plan

Rate Limit (API Calls)

Rate Limit Window

Developer

100

60 seconds

Startup

500

60 seconds

Enterprise

Custom

60 seconds

The limits apply per key, not per account. So requests performed with your Bearer Secret Key, are counted separately from the requests performed with your Bearer Publishable Key.

Rate Limits Window

Rate limits are counted per 60 seconds intervals.

HTTP Headers and Response codes

Bearer uses HTTP headers to make it easy to understand your API calls consumption, right from your application. Here are the headers sent alongside every response:

  • Bearer-RateLimit-Limit: The Rate Limit applied to the account

  • Bearer-RateLimit-Remaining: The remaining API calls before the end of the 60 seconds Rate Limit Window

  • Bearer-RateLimit-Reset: The number of seconds remaining before the Rate Limit gets reset

When you hit the Rate Limit, Bearer will fail and return a 429 Too Many Requests