API limits

Rate limit

We have request limits on certain endpoints where abuse could potentially compromise the performance and use of Asaas APIs. We measure requests and can restrict them when the allowed quantity is exceeded.

You can check the status in the response headers after a request:

RateLimit-Limit: 100
RateLimit-Remaining: 50
RateLimit-Reset: 30

The RateLimit-Reset header contains the remaining seconds until the limit resets.

If the limit is reached or exceeded (RateLimit-Remaining: 0), you will receive an HTTP 429 Too Many Requests error.

Quota limit

We have an API usage quota limit every 12 hours. The limit is 25,000 requests per account regardless of the accessed endpoint. The counter starts from the time of the first request and increments for the next 12 hours, then resets to zero and starts counting again for the next 12 hours.

If the limit is reached or exceeded, you will receive an HTTP 429 Too Many Requests error.

Concurrent request limit

Concurrent requests are those submitted to Asaas before the previous request has been responded to.

You can perform up to 50 concurrent GET requests to our API. If this limit is exceeded, your application will receive an HTTP 429 Too Many Requests error in the requests.