Consultar a sua cota

O endpoint GET /cota devolve, para a sua conta, quanto do plano você já usou no mês e quanto ainda resta. Use-o para acompanhar o consumo e evitar surpresas com o 429.

Método e caminho: GET /cota
Base URL: https://api.cnpjapi.com.br
Autenticação: API key no cabeçalho Authorization: Bearer (veja Autenticação).
Não debita cota: consultar o seu uso não conta como uma consulta.

Exemplo (curl)

curl https://api.cnpjapi.com.br/cota \
  -H "Authorization: Bearer cnpj_sua_chave"

Resposta (`200 OK`, `application/json`)

{
  "competencia": "2026-08",
  "usado": 1234,
  "limite": 100000,
  "restante": 98766,
  "rpm": 30
}

Campos da resposta

Campo	Descrição
`competencia`	Mês de referência da cota, no formato `YYYY-MM`
`usado`	Consultas já feitas na competência
`limite`	Cota mensal do seu plano (`0` = sem limite)
`restante`	Consultas restantes no mês (`null` = sem limite)
`rpm`	Limite de requisições por minuto do seu plano

Contas isentas (ou sem limite em algum eixo) recebem limite: 0 e restante: null - é o sinal de ilimitado naquele eixo.

Erros

Status	Significado
`401`	API key ausente ou inválida - o endpoint exige chave (não há versão anônima)
`429`	Muitas chamadas ao próprio `/cota` em pouco tempo; respeite o `Retry-After`

Veja todos os códigos em Erros.

Próximos passos

Limites e planos - o que cada plano permite e o comportamento no 429.
Consultar um CNPJ - o endpoint principal.

Crie sua conta gratuita em https://app.cnpjapi.com.br e acompanhe o seu consumo em tempo real.