Consulta de CNPJ em lote: até 1.000 CNPJs por envio
Envie uma lista de CNPJs, numéricos ou alfanuméricos, e receba razão social, situação cadastral, atividade e sócios de cada um. O processamento roda em segundo plano e você é avisado ao terminar.
Só os CNPJs encontrados consomem crédito. Sandbox sem custo.
Andamento do lote
- Total
- 500 CNPJs
- Encontrados
- 497
- Não encontrados
- 2
- Inválidos
- 1
Análise de carteira sem planilhas
A mesma resposta da consulta unitária de CNPJ, para a lista inteira.
- Até 1.000 CNPJs por envio
- Com ou sem pontuação, numéricos ou alfanuméricos. Também aceita a lista só com os textos dos CNPJs.
- Os mesmos dados da consulta unitária
- Razão social, situação, CNAE, porte, endereço, Simples e MEI e quadro societário de cada empresa.
- Validação item a item
- Formato e dígitos verificadores são conferidos na entrada. Um item inválido não derruba o lote nem é cobrado.
- Processamento assíncrono
- A API responde 202 com o batch_id e trabalha em segundo plano. Acompanhe pelo status ou receba o webhook batch.completed.
- Resultados paginados
- Cada CNPJ volta com status (encontrado, não encontrado, inválido ou erro) e disponível por 24 horas.
- Dados Abertos da Receita
- A fonte é a mesma da consulta unitária: os Dados Abertos do CNPJ, com até 30 dias de defasagem.
Como funciona
- 1
Você envia a lista
A API valida o formato e os dígitos verificadores de cada item e enfileira o processamento. A resposta 202 traz o batch_id.
- 2
O processamento roda em segundo plano
Cada CNPJ é resolvido nos Dados Abertos, e só os encontrados são cobrados.
- 3
Você acompanha e lê os resultados
Consulte o status até completed, ou espere o webhook. Os resultados ficam disponíveis por 24 horas.
Envie a lista, acompanhe depois
Um POST com a lista de CNPJs devolve o batch_id para acompanhar o lote.
Documentação do endpointcURL POST /v1/cnpj/batch
Resposta
Lote aceito. Acompanhe pelo batch_id.
Saldo insuficiente para cobrir o lote: nada foi processado.
Quanto custa
1 crédito por CNPJ encontrado
Inválidos, não encontrados e falhas da fonte não cobram. O saldo precisa cobrir o lote inteiro, a menos que o plano permita excedente.
Sandbox sem custo
Chaves de sandbox (brz_test_) processam o lote com CNPJs de teste e nunca debitam saldo.
Mesmo saldo do CPF
Os créditos do plano valem para consultas de CPF e de CNPJ, unitárias ou em lote, e para o dossiê.
Onde usar
Análise de carteira B2B
Descubra quais clientes estão com a empresa baixada, inapta ou suspensa antes de renovar contratos.
Homologação de fornecedores
Confira situação, atividade e sócios de toda a base de fornecedores em uma rodada.
Enriquecimento de leads
Complete listas de prospecção com porte, atividade e localização de cada empresa.
Perguntas frequentes
Qual o tamanho máximo do lote?
Até 1.000 CNPJs por envio. Para listas maiores, envie vários lotes em sequência.
O lote aceita CNPJ alfanumérico?
Sim. Desde julho de 2026 a Receita emite CNPJs com letras e números, e a validação e a consulta funcionam para os dois formatos.
De onde vêm os dados?
Dos Dados Abertos do CNPJ, publicados pela Receita Federal. Não é uma consulta em tempo real ao sistema da Receita: os dados refletem a última publicação, com até 30 dias de defasagem.
Por quanto tempo os resultados ficam disponíveis?
Por 24 horas depois do envio. Para guardar, grave os resultados no seu sistema.
Como sou avisado quando o lote termina?
Cadastre um webhook no painel e receba o evento batch.completed, que traz só contadores e datas. Os resultados você lê pela API.
Outros produtos da BrazID
Todos usam a mesma chave de API e o mesmo saldo de créditos.
Valide toda a sua carteira de empresas
Crie sua conta, teste o lote no sandbox e processe sua lista de CNPJs em minutos.
Só os CNPJs encontrados consomem crédito. Sandbox sem custo.