Consulta de CNPJ em lote

Envia até 1.000 CNPJs de uma vez. O processamento é assíncrono: a API responde 202 com um batch_id e você acompanha o andamento ou aguarda o webhook. A fonte é a mesma da consulta unitária: os Dados Abertos do CNPJ.

Corpo da requisição

[]arrayobrigatório

Lista de 1 a 1.000 itens.

[].cnpjstringobrigatório

CNPJ com ou sem pontuação, numérico ou alfanumérico. Também é aceito enviar a lista só com os textos dos CNPJs.

1 crédito por item encontrado.

• O saldo precisa cobrir o lote inteiro, a menos que o seu plano permita excedente. Sem saldo, a resposta é 402 e o lote não começa.
• Itens inválidos (formato ou dígito verificador), não encontrados e falhas da fonte não cobram. Você pode reenviar apenas os que falharam.
• O lote usa o mesmo saldo e os mesmos limites de requisições da consulta unitária.

Como o lote é processado

1. 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. 2

   O processamento roda em segundo plano

   Cada CNPJ é resolvido nos Dados Abertos, e só os encontrados são cobrados.

3. 3

   Você acompanha

   Consulte o GET /v1/cnpj/batch/{id} até o status ser completed, ou receba o evento batch.completed no seu webhook.

4. 4

   Você lê os resultados

   Os resultados saem paginados e ficam disponíveis por 24 horas.

Campos da resposta 202

batch_idstring

Identificador do lote. Use-o para acompanhar.

statusstring

processing ou completed.

totalnumber

Quantidade de itens do lote.

processednumber

Itens já resolvidos (no início, só os inválidos).

found / not_found / invalid / errorsnumber

Contadores por resultado até o momento.

status_urlstring

Caminho para acompanhar o lote. Também vem no cabeçalho Location.

credits_remainingnumber

Saldo atual. Pode ser ocultado no painel.