CNPJAPI

Consultar CNPJ em lote

Precisa processar uma lista de CNPJs? A CNPJAPI tem um endpoint dedicado: POST /consulta/lote consulta até 20 CNPJs numa única chamada - disponível para contas com plano pago (não está no plano gratuito).

Referência completa (corpo, resposta, erros): Consultar CNPJs em lote.

Como funciona

  • Envie até 20 CNPJs de uma vez em {"cnpjs": [...]}.
  • A resposta traz um item por CNPJ, na mesma ordem da lista enviada, com status: encontrado, nao_encontrado, invalido ou erro.
  • Um item com problema não derruba o lote - os demais são processados normalmente.
  • A chamada conta como 1 requisição pro limite por minuto; a cota mensal debita só os CNPJs resolvidos (encontrado).
  • Sua lista tem mais de 20? Divida em vários lotes de até 20, respeitando o rate limit entre as chamadas.

Exemplo (Python)

import requests

API_KEY = "cnpj_sua_chave"
cnpjs = ["00776574000156", "00000000000000", "abc"]  # sua lista, até 20 por chamada

resposta = requests.post(
    "https://api.cnpjapi.com.br/consulta/lote",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"cnpjs": cnpjs},
    timeout=15,
)
resposta.raise_for_status()

for item in resposta.json():
    if item["status"] == "encontrado":
        print(item["cnpj"], "-", item["dados"]["RazaoSocial"])
    else:
        print(item["cnpj"], "-", item["status"])

O mesmo padrão vale em qualquer linguagem: um POST só, com a lista inteira no corpo. Veja os guias por linguagem em Guias de integração e os exemplos completos em github.com/guidi-sistemas/cnpjapi-examples.

Sem plano pago?

O lote responde 403 pra contas sem plano pago. Nesse caso (ou pra consultas avulsas), use GET /{cnpj} uma vez por CNPJ, respeitando o rate limit - veja Consultar um CNPJ.

Dicas

  • Mais de 20 CNPJs? Divida em lotes de 20 e distribua as chamadas no tempo.
  • Trate erro/nao_encontrado/invalido por item: não interrompem o lote, mas merecem tratamento separado do encontrado.
  • Formato ReceitaWS? ?formato=receitaws também funciona no lote - veja o aviso sobre itens de erro em Consultar CNPJs em lote.
  • Precisa de mais volume? Compare os planos em https://cnpjapi.com.br/#planos.

Próximos passos