Consulta de CNPJ por lotes: hasta 1.000 CNPJ por envío
Envía una lista de CNPJ, numéricos o alfanuméricos, y recibe razón social, situación, actividad y socios de cada uno. El procesamiento corre en segundo plano y se te avisa al terminar.
Solo los CNPJ encontrados consumen crédito. Sandbox sin costo.
Avance del lote
- Total
- 500 CNPJ
- Encontrados
- 497
- No encontrados
- 2
- Inválidos
- 1
Análisis de cartera sin planillas
La misma respuesta de la consulta individual de CNPJ, para toda la lista.
- Hasta 1.000 CNPJ por envío
- Con o sin puntuación, numéricos o alfanuméricos. También acepta la lista solo con los textos de los CNPJ.
- Los mismos datos de la consulta individual
- Razón social, situación, CNAE, tamaño, dirección, Simples y MEI y socios de cada empresa.
- Validación ítem por ítem
- El formato y los dígitos verificadores se revisan en la entrada. Un ítem inválido no tumba el lote ni se cobra.
- Procesamiento asíncrono
- La API responde 202 con el batch_id y trabaja en segundo plano. Sigue el estado o recibe el webhook batch.completed.
- Resultados paginados
- Cada CNPJ vuelve con un estado (encontrado, no encontrado, inválido o error), disponible 24 horas.
- Datos Abiertos de la Receita Federal
- La fuente es la misma de la consulta individual: los Datos Abiertos del CNPJ, con hasta 30 días de desfase.
Cómo funciona
- 1
Envías la lista
La API valida el formato y los dígitos verificadores de cada ítem y encola el procesamiento. La respuesta 202 trae el batch_id.
- 2
El procesamiento corre en segundo plano
Cada CNPJ se resuelve en los Datos Abiertos y solo se cobran los encontrados.
- 3
Sigues el avance y lees los resultados
Consulta el estado hasta completed, o espera el webhook. Los resultados quedan disponibles 24 horas.
Envía la lista, sigue el avance después
Un POST con la lista de CNPJ devuelve el batch_id para seguir el lote.
Documentación del endpointcURL POST /v1/cnpj/batch
Respuesta
Lote aceptado. Síguelo con su batch_id.
Saldo insuficiente para cubrir el lote: no se procesó nada.
Cuánto cuesta
1 crédito por CNPJ encontrado
Los ítems inválidos, no encontrados y las fallas de la fuente no se cobran. El saldo debe cubrir todo el lote, salvo que tu plan permita excedente.
Sandbox sin costo
Las claves de sandbox (brz_test_) procesan el lote con CNPJ de prueba y nunca debitan el saldo.
El mismo saldo del CPF
Los créditos del plan valen para consultas de CPF y de CNPJ, individuales o por lotes, y para el dossier.
Dónde usarlo
Análisis de cartera B2B
Descubre qué clientes tienen la empresa dada de baja, inhábil o suspendida antes de renovar contratos.
Homologación de proveedores
Revisa situación, actividad y socios de toda la base de proveedores en una pasada.
Enriquecimiento de leads
Completa listas de prospección con tamaño, actividad y ubicación de cada empresa.
Preguntas frecuentes
¿Cuál es el tamaño máximo del lote?
Hasta 1.000 CNPJ por envío. Para listas mayores, envía varios lotes en secuencia.
¿El lote acepta CNPJ alfanumérico?
Sí. Desde julio de 2026 la Receita Federal emite CNPJ con letras y números, y la validación y la consulta funcionan para ambos formatos.
¿De dónde vienen los datos?
De los Datos Abiertos del CNPJ, publicados por la Receita Federal. No es una consulta en tiempo real al sistema de la Receita: los datos reflejan la última publicación, con hasta 30 días de desfase.
¿Cuánto tiempo quedan disponibles los resultados?
24 horas después del envío. Para conservarlos, guarda los resultados en tu propio sistema.
¿Cómo me avisan cuando termina el lote?
Registra un webhook en el panel y recibe el evento batch.completed, que trae solo contadores y fechas. Los resultados los lees por la API.
Otros productos de BrazID
Todos usan la misma clave de API y el mismo saldo de créditos.
Valida toda tu cartera de empresas
Crea tu cuenta, prueba el lote en el sandbox y procesa tu lista de CNPJ en minutos.
Solo los CNPJ encontrados consumen crédito. Sandbox sin costo.