Consulta de CNPJ em Lote
Consulta de CNPJ em lote:
sua lista inteira de uma vez.
Envie até 10.000 CNPJs pela API ou suba uma planilha CSV no painel e receba razão social, situação cadastral, CNAE, endereço e sócios de cada empresa. Só os CNPJs encontrados consomem crédito.
50 créditos grátis por mês, sem cartão de crédito.
O que você recebe
Dez mil CNPJs. Uma requisição.
Fila, paralelismo e retentativa ficam do nosso lado. Você envia a lista e acompanha.
Até 10.000 CNPJs por lote
A lista inteira vai em um POST e o jobId volta na hora. Duplicados são removidos, e cada CNPJ é consultado e cobrado uma vez.
Resultado parcial durante o processamento
A cada consulta ao status, você vê quantos CNPJs já foram processados e os registros prontos, sem esperar o lote terminar.
Os mesmos campos da Consulta de CNPJ
Cada CNPJ encontrado volta com o registro completo: razão social, situação cadastral, CNAE, endereço e quadro de sócios. Não encontrado volta com found: false.
razao_socialsituacao_cadastralcnae_principalmunicipioufQSAPlanilha, sem programar
No painel, suba um arquivo CSV ou TXT ou cole a lista. A coluna de CNPJ é identificada sozinha, e o resultado sai em CSV pronto para abrir no Excel.
Como funciona
Envie a lista. Acompanhe o lote.
O processamento é assíncrono: a sua requisição não fica esperando dez mil consultas terminarem.
- 01
Envie a lista
Um POST /cnpj/bulk com o array de CNPJs. A resposta chega na hora com o jobId, e o processamento continua em segundo plano.
- 02
Acompanhe o lote
Consulte GET /cnpj/bulk/{jobId} quando quiser. Acompanhar não consome crédito e funciona até com saldo zerado.
- 03
Use o resultado
Um item por CNPJ, com o mesmo registro da consulta individual. No painel, você baixa o CSV pronto.
Um CNPJ por vez? Use a Consulta de CNPJ. Para pessoas físicas, existe a Consulta de CPF em Lote.
Integre em qualquer linguagem
Dois passos: você envia a lista de CNPJs e depois consulta o lote. Nada além de HTTP.
# Passo 1: POST com array de CNPJs em JSON
curl -X POST "https://api.cpfhub.io/cnpj/bulk" \
-H "x-api-key: SUA_API_KEY" \
-H "content-type: application/json" \
-d '{"cnpjs": ["11222333000181", "12ABC34501DE35"]}'
# → 202 Accepted { "jobId": "4a1ef25e-052c-4464-..." }
# Passo 2: polling até status "done"
curl "https://api.cpfhub.io/cnpj/bulk/4a1ef25e-052c-4464-9657-4148f53bb0fc" \
-H "x-api-key: SUA_API_KEY"{
"success": true,
"data": {
"id": "4a1ef25e-052c-4464-9657-4148f53bb0fc",
"status": "done",
"total_records": 2,
"processed": 2,
"found": 1,
"not_found": 1,
"skipped": 0,
"error": null,
"cnpjs": [
{
"cnpj": "11222333000181",
"found": true,
"data": {
"cnpj": "11222333000181",
"razao_social": "EMPRESA EXEMPLO LTDA",
"situacao_cadastral": "Ativa",
"cnae_principal": "6201501",
"uf": "SP",
"municipio": "SAO PAULO"
}
},
{
"cnpj": "12ABC34501DE35",
"found": false,
"data": null
}
]
}
}50 créditos grátis por mês, sem cartão.
Acompanhamento
Você sabe onde o lote está.
Três status possíveis e cinco contadores. Você sabe se o lote está rodando, se terminou ou se parou.
processing
O lote está rodando. Consultar o status devolve o progresso e os CNPJs já consultados.
done
O lote terminou. A resposta traz um item por CNPJ, com o registro completo dos encontrados.
failed
O lote parou. O campo error explica o motivo, e só os CNPJs já encontrados foram cobrados.
Contadores do lote
total_recordsQuantos CNPJs válidos e únicos entraram no lote.
processedQuantos já foram consultados.
foundQuantos existem na base. É o que você paga.
not_foundQuantos não têm registro. Não cobram.
skippedQuantos ficaram de fora porque o saldo acabou durante o processamento.
Onde usar
Quando a lista é grande demais.
Situações em que conferir um CNPJ por vez levaria dias, e ninguém faria.
Saneamento de fornecedores
Descubra quais fornecedores estão baixados, inaptos ou suspensos antes do próximo pagamento.
Carteira de clientes B2B
Atualize razão social, endereço e CNAE da carteira inteira e encontre as empresas que fecharam.
Migração de ERP ou CRM
Antes de levar o cadastro para o sistema novo, confirme quais CNPJs existem e padronize os dados.
Revisão periódica da carteira
Rode o lote todo mês e veja quais clientes mudaram de situação cadastral, de porte ou de opção pelo Simples.
Segmentação por CNAE e região
Agrupe a sua lista de empresas por atividade, porte, UF e município para planejar vendas e atendimento.
Due diligence em aquisições
Recebeu a carteira de outra empresa? O lote mostra quantos CNPJs estão ativos sem ninguém conferir um por um.
Como cobra
Você paga pelos CNPJs que existem.
Lista antiga tem CNPJ digitado errado, repetido ou que nunca existiu. Aqui, nada disso consome crédito.
1 crédito
por CNPJ encontrado, como na consulta individual
R$ 0
por CNPJ não encontrado, inválido ou repetido
10.000
CNPJs por lote, quantos lotes você precisar
Em planos sem excedente, o lote só é aceito se houver saldo para todos os CNPJs válidos. Se o saldo acabar durante o processamento, os CNPJs restantes voltam como skipped, sem consulta e sem cobrança.
Perguntas frequentes
Quantos CNPJs posso consultar por lote?
Até 10.000 por envio. Para listas maiores, divida em blocos e envie um lote para cada um. Duplicados são removidos, e cada CNPJ é consultado e cobrado uma vez.
Posso enviar uma planilha?
Sim. No painel da CPFHub.io, em Consultas, CNPJ Em Lote, envie um arquivo CSV ou TXT ou cole a lista. A coluna de CNPJ é identificada automaticamente, e o resultado pode ser baixado em CSV. Arquivos XLSX ainda não são aceitos: salve a planilha como CSV antes de enviar.
Quanto custa consultar CNPJ em lote?
1 crédito por CNPJ encontrado, o mesmo custo da consulta individual, descontado do mesmo saldo do plano, inclusive dos 50 créditos mensais do plano Grátis. CNPJ não encontrado, inválido ou repetido não consome crédito, e acompanhar o status do lote também não.
Quais dados voltam para cada CNPJ?
O mesmo registro da Consulta de CNPJ: razão social, nome fantasia, situação cadastral, CNAE principal e secundários, natureza jurídica, endereço, contatos, porte, capital social, opção pelo Simples Nacional e pelo MEI e o quadro de sócios, com o CPF de sócio pessoa física mascarado. O CSV do painel traz as colunas principais.
Como funciona o lote pela API?
Envie os CNPJs em POST /cnpj/bulk com o body {"cnpjs": [...]}. A API responde 202 com o jobId. Consulte GET /cnpj/bulk/{jobId} até o status ficar done ou failed. Enquanto o lote roda, a resposta já traz os resultados parciais.
E se o saldo acabar no meio do lote?
Em planos sem excedente, o lote só é aceito se o saldo cobrir todos os CNPJs válidos. Se o saldo acabar durante o processamento, os CNPJs restantes voltam como skipped, sem consulta e sem cobrança. Recarregue e envie só os que faltaram.
Com que frequência os dados são atualizados?
Os dados vêm da base pública do CNPJ publicada pela Receita Federal, atualizada mensalmente. O lote não consulta a Receita em tempo real: cada registro reflete a última base mensal.
O lote aceita o CNPJ alfanumérico?
Sim. A lista pode misturar CNPJs numéricos e alfanuméricos, com ou sem máscara. Os dígitos verificadores são conferidos antes do processamento, e CNPJs inválidos ficam de fora, sem custo.
Consulte sua lista
de CNPJs ainda hoje.
- 50 créditos grátis por mês
- Sem cartão de crédito
- Atendimento 24h no WhatsApp