Quotas and limits

To prevent abuse of our platform, we enforce various account limits. We'd like to be as permissive as possible while preventing an unreasonable burden on our infrastructure.

Description	Limit
API quota: Free plan	50 requests per day
API quota: Pro and Startup plans	1,000 requests per day
API quota: Business plan	2,500 requests per day
Auth tokens per account	5, increase via support
Sites per account	50, increase via support
Third-party integrations	25, increase via support

If your use case requires an increase on one of your quotas, please contact us. We will evaluate your use case, and notify you if we're able to grant you the increase. As a rule of thumb, plan adjustments require a subscription to a paid plan.

Rate limiting

To help you monitor your daily API quota, every request includes HTTP headers with information about your current rate limits. For example:

$ curl "https://api.panelbear.com/v1/sites"

< HTTP/1.1 200 OK
< Date: Mon, 08 Jul 2021 14:10:05 GMT
< X-RateLimit-Limit: 5000
< X-RateLimit-Remaining: 4715
< X-RateLimit-Reset: 1620334506

Here's what these headers mean:

Description	Limit
`X-RateLimit-Limit`	The maximum number of requests you're allowed to make per time window.
`X-RateLimit-Remaining`	The remaining number of requests you're allowed to make within the current time window.
`X-RateLimit-Reset`	The unix timestamp at which the current time window resets for rate limiting purposes.

Once you run out of requests for the current time window, your requests will be rejected with the following response.

$ curl "https://api.panelbear.com/v1/sites"

< HTTP/1.1 429 Too Many Requests
< Date: Mon, 08 Jul 2021 14:10:05 GMT
< X-RateLimit-Limit: 5000
< X-RateLimit-Remaining: 0
< X-RateLimit-Reset: 1620334506

{
  "message": "API rate limit exceeded. Please wait a while before trying again."
}