API de consulta de CNPJ con los Datos Abiertos de la Receita
Envíe un CNPJ y reciba razón social, situación cadastral, actividad, dirección y socios en un JSON estándar. Acepta el número con o sin puntuación y ya funciona con el nuevo CNPJ alfanumérico.
Plan gratuito con 20 consultas al mes. Sin tarjeta de crédito.
Resultado de la consulta
- CNPJ
- 12.345.678/0001-95
- Razón social
- Empresa Exemplo Tecnologia Ltda
- Situación
- Activa
- Actividad principal
- 6201501
Qué devuelve la consulta
Los datos públicos del registro, listos para validar a un cliente, un proveedor o un socio comercial.
- Identificación
- CNPJ, razón social, nombre de fantasía, naturaleza jurídica y capital social, en el formato que usa la Receita.
- Situación cadastral
- Activa, dada de baja, inapta o suspendida, con la fecha de la situación y la fecha de apertura de la empresa.
- Actividades y tamaño
- CNAE principal y secundarios, tamaño de la empresa, casa matriz o sucursal y la adhesión al Simples Nacional y al MEI, con fechas.
- Dirección
- Calle, número, complemento, barrio, ciudad, estado y código postal de la sede registrada, más el correo y los teléfonos de la empresa.
- Socios
- Nombre, calificación, tipo (persona física, jurídica o extranjero), documento parcialmente oculto, rango de edad y fecha de ingreso en la sociedad de cada socio o administrador.
- Actualización de los datos
- Los datos reflejan la última publicación de la Receita Federal en los Datos Abiertos, con hasta 30 días de desfase.
Cómo funciona la consulta
- 1
Validación local
Antes de cualquier búsqueda comprobamos el formato y los dígitos verificadores. Un CNPJ inválido devuelve error 400 y no gasta crédito.
- 2
Respuesta rápida
Si el CNPJ ya fue consultado recientemente, la respuesta sale en milisegundos.
- 3
Datos Abiertos de la Receita
Cuando es necesario, consultamos los Datos Abiertos del CNPJ y devolvemos el resultado.
Lista para el CNPJ alfanumérico
Desde julio de 2026 la Receita Federal emite CNPJ con letras y números. BrazID ya valida y consulta ambos formatos, sin cambios en su integración.
12.ABC.345/01DE-35
- Cómo es el nuevo formato
- 14 caracteres: los 12 primeros pueden ser letras (A a Z) o dígitos, y los 2 últimos son siempre dígitos verificadores. Ejemplo: 12.ABC.345/01DE-35.
- Validación con el método oficial
- Calculamos los dígitos verificadores como lo define la Receita. El CNPJ numérico sigue vigente y se comprueba igual.
- Entrada flexible
- Con o sin puntuación, en mayúsculas o minúsculas. La API normaliza antes de consultar y la respuesta devuelve el CNPJ sin puntuación.
- Valide gratis
- La ruta POST /v1/validate comprueba CPF y CNPJ, incluido el alfanumérico, sin gastar crédito.
Una llamada, un JSON
Autentíquese con el encabezado x-api-key y pase el CNPJ en la ruta, con o sin puntuación.
Documentación del endpointcURL GET /v1/cnpj/12345678000195
Respuesta
Consulta completada con éxito.
CNPJ no encontrado en el registro de la Receita Federal.
Cuánto cuesta
1 crédito por consulta exitosa
Solo la respuesta 200 consume crédito. CNPJ inválido (400), no encontrado (404) e indisponibilidad (503) no cobran nada.
Sandbox sin costo
Las claves de sandbox (brz_test_) responden con datos de prueba y nunca descuentan saldo. Úselas para integrar sin gastar créditos.
Mismo saldo que el CPF
Los créditos del plan sirven para consultas de CPF y de CNPJ. Superada la franquicia, el excedente sigue la regla de su plan.
Dónde usarla
Alta de clientes B2B
Complete razón social y dirección a partir del CNPJ y rechace empresas dadas de baja o inaptas.
Análisis de proveedores y socios comerciales
Confirme la situación cadastral y los socios antes de firmar un contrato.
Enriquecimiento de bases
Actualice bases de leads y clientes con actividad y ubicación.
Preguntas frecuentes
¿De dónde vienen los datos del CNPJ?
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.
¿La API acepta el CNPJ alfanumérico?
Sí. Desde julio de 2026 la Receita emite CNPJ con letras y números. La validación de los dígitos verificadores y la consulta funcionan con ambos formatos.
¿Qué pasa si envío un CNPJ inválido?
La API responde 400 con el error INVALID_CNPJ_FORMAT, sin consultar ninguna fuente y sin gastar crédito. Si solo quiere comprobar el número, POST /v1/validate es gratuita.
¿Los datos incluyen documento, correo o teléfono de los socios?
Solo en parte. Devolvemos nombre, calificación, rango de edad, fecha de ingreso y el documento ya parcialmente oculto por la Receita (ej.: ***345856**). El documento completo, correos y teléfonos no forman parte de la respuesta.
¿Cuánto cuesta cada consulta?
Cada respuesta 200 consume 1 crédito de su plan. El plan gratuito incluye 20 créditos al mes, sin tarjeta. Vea los planes en la página de precios.
Valide empresas sin armar planillas
Cree su cuenta, genere una clave de sandbox y haga su primera consulta de CNPJ en minutos.
Plan gratuito con 20 consultas al mes. Sin tarjeta de crédito.