Limitations

The Public API has a limitation of serving only 3 requests per minute from the same IP. Understand that this limitation is independent of whether the query was successful in finding the CNPJ. After exceeding this limit, the requester will have to wait for 60 seconds to make the next request.

The user will receive an error message and HTTP Status Code 429:

{
  "status": 429,
  "title": "Too Many Requests",
  "details": "Exceeded the maximum limit of 3 queries per minute. Release will occur on Thu Jun 03 2021 16:15:00 GMT-0300 (Brasilia Standard Time)"
}

If the API identifies that the user has made more than 360 queries per hour (the allowed limit is 3 x 60 = 180), the user will be penalized and will not be able to make queries for 1 hour. If this persists, the penalty will be renewed for another hour. Example:

{
  "status": 429,
  "title": "Too Many Requests",
  "details": "Exceeded the maximum limit of 429 errors per hour. Release will occur on Thu Jun 03 2021 16:15:00 GMT-0300 (Brasilia Standard Time)"
}