Limites de Uso

Todos os endpoints da API possuem limites de requisições por token. Os limites variam de acordo com o tipo de token utilizado.

Limites por plano

Plano	Limite	Reset	Volume mensal estimado
Free	5 requisições por minuto	1 minuto	~216.000
Basic	10 requisições por minuto	1 minuto	~432.000
Pro	90 requisições por minuto	1 minuto	~3.888.000

O volume mensal é uma estimativa baseada em uso contínuo: limite × 60 × 24 × 30. Não há limite mensal — apenas o rate limit por minuto é aplicado.

Comportamento ao atingir o limite

Quando o limite de requisições é atingido, a API retorna o status HTTP 429 Too Many Requests:

{
  "error": "Limite de requisições excedido."
}

Aguarde o período de reset antes de fazer novas requisições.

Limites por endpoint

Todos os endpoints possuem o mesmo limite de 5 consultas por minuto para tokens gratuitos:

Endpoint	Limite (gratuito)
`GET /v1/cnpj/{cnpj}`	5 req/min
`GET /v1/logos/{cnpj}`	5 req/min
`GET /v1/simples/{cnpj}`	5 req/min
`GET /v1/cidades/{id}`	5 req/min

Upgrade

Para aumentar seus limites, faça upgrade do seu plano em Minha Conta. Para necessidades enterprise, entre em contato pelo email [email protected].

Introdução

Autenticação

Endpoints

Skill CNPJ

Migração

Suporte

Limites de Uso

Limites de Uso

Limites por plano

Comportamento ao atingir o limite

Limites por endpoint

Upgrade

​Limites de Uso

​Limites por plano

​Comportamento ao atingir o limite

​Limites por endpoint

​Upgrade

Limites de Uso

Limites por plano

Comportamento ao atingir o limite

Limites por endpoint

Upgrade