Consulta de CNPJ
Consulta de CNPJ por API,
con situación y socios.
Envía el CNPJ (el número de identificación fiscal de empresas en Brasil) y recibe en JSON la razón social, la situación de registro, el CNAE, la dirección y el cuadro de socios. Acepta el CNPJ alfanumérico y usa la misma clave y el mismo saldo que la consulta de CPF.
50 créditos gratis al mes, sin tarjeta de crédito. El mismo saldo sirve para CPF y CNPJ.
Qué recibes
El registro de la empresa en una respuesta.
Los datos públicos del CNPJ organizados en JSON, listos para guardar en tu sistema.
Identificación y situación de registro
Razón social, nombre comercial, matriz o sucursal, naturaleza jurídica y la situación de registro con su fecha, para saber si la empresa está activa, dada de baja, inapta o suspendida.
razao_socialnome_fantasiasituacao_cadastraldata_situacao_cadastralmatriz_filialnatureza_juridicaActividad, tamaño y régimen
CNAE principal y secundarios, fecha de apertura, tamaño, capital social y las opciones por el Simples Nacional y el MEI.
cnae_principalcnaes_secundariosdata_inicio_atividadeporte_empresacapital_socialopcao_simplesopcao_meiDirección y contacto
Calle, número, barrio, código postal, municipio y estado del establecimiento, además del correo y los teléfonos registrados en la Receita Federal.
logradourobairrocepmunicipioufemailtelefonesCuadro de socios (QSA)
Nombre, calificación, fecha de ingreso y rango de edad de cada socio y administrador. El CPF del socio persona física siempre viene enmascarado.
QSAnome_socioqualificacao_sociocnpj_cpf_socio¿Muchos CNPJ a la vez? La Consulta de CNPJ por Lote recibe hasta 10.000 por envío, con los mismos campos.
Ver todos los campos en la documentaciónCómo funciona
Una llamada GET. Ningún contrato.
La misma integración de la consulta de CPF, con otra ruta.
- 01
Crea la cuenta
Registro self-serve en app.cpfhub.io, sin tarjeta. La clave de API aparece en el panel enseguida.
- 02
Llama a GET /cnpj/{cnpj}
Envía el CNPJ con o sin formato, numérico o alfanumérico, con la clave en el header x-api-key. El dígito verificador se valida antes de la búsqueda.
- 03
Usa el JSON
Guarda la razón social, revisa la situación de registro o completa la dirección del cliente. Un CNPJ no encontrado devuelve 404 y no consume crédito.
Intégrala en cualquier lenguaje
La misma clave de la consulta de CPF, con la ruta /cnpj. Ejemplos listos en diez lenguajes.
curl -X GET \
'https://api.cpfhub.io/cnpj/11222333000181' \
-H 'x-api-key: YOUR_API_KEY'{
"success": true,
"data": {
"cnpj": "11222333000181",
"razao_social": "EMPRESA EXEMPLO LTDA",
"nome_fantasia": "EXEMPLO",
"situacao_cadastral": "Ativa",
"data_situacao_cadastral": "2015-03-10",
"matriz_filial": "Matriz",
"data_inicio_atividade": "2015-03-10",
"cnae_principal": "6201501",
"cnaes_secundarios": ["6204000", "6311900"],
"natureza_juridica": "Sociedade Empresária Limitada",
"logradouro": "DAS FLORES",
"numero": "100",
"bairro": "CENTRO",
"cep": "01001000",
"uf": "SP",
"municipio": "SAO PAULO",
"capital_social": "100000,00",
"porte_empresa": "Microempresa (ME)",
"opcao_simples": "S",
"opcao_mei": "N",
"QSA": [
{
"nome_socio": "FULANO DE TAL",
"cnpj_cpf_socio": "***.456.789-**",
"qualificacao_socio": "Sócio-Administrador"
}
]
}
}50 créditos gratis al mes, sin tarjeta.
De dónde vienen los datos
Base pública, reglas claras.
Sabes qué estás consultando y hasta dónde llega la respuesta.
Datos abiertos de la Receita Federal
Los datos vienen de la base pública del CNPJ publicada por la Receita Federal de Brasil, actualizada cada mes. No es una consulta en tiempo real: la respuesta refleja la última base publicada.
CNPJ alfanumérico
La Receita Federal empezó a emitir CNPJ con letras en julio de 2026. La API ya valida y consulta los dos formatos, con o sin puntuación.
CPF del socio enmascarado
El CPF del socio persona física nunca vuelve completo. Recibes el nombre y la calificación sin exponer el documento.
Dónde usarla
Donde la empresa necesita verificarse.
Situaciones en las que un CNPJ erróneo o inactivo se convierte en pérdida, factura rechazada o retrabajo.
Registro de clientes empresa
Confirma que el CNPJ existe y está activo antes de habilitar la cuenta, el crédito o el pedido.
Homologación de proveedores
Revisa la situación de registro, el CNAE y el cuadro de socios antes de firmar el contrato o pagar la primera factura.
Formularios que se completan solos
El cliente escribe el CNPJ y el formulario completa la razón social y la dirección. Menos tecleo, menos errores.
Emisión de facturas
Revisa la dirección, el municipio y la opción por el Simples Nacional antes de emitir, para evitar facturas rechazadas.
Análisis de crédito empresarial
La fecha de apertura, el tamaño y el capital social ayudan a distinguir la empresa abierta el mes pasado de la que opera hace años.
Agentes de IA y automatizaciones
Una ruta GET con JSON predecible. Tu agente o tu automatización consultan el CNPJ con una solicitud HTTP.
Créditos y códigos
Solo pagas por el CNPJ que existe.
El mismo costo y el mismo saldo que la Consulta Simple de CPF. Los errores, los CNPJ inválidos y los no encontrados no consumen crédito.
Cómo funciona el crédito
- 1 crédito por CNPJ encontrado, descontado del mismo saldo que usas para CPF.
- Los 50 créditos mensuales del plan Gratis también sirven para CNPJ.
- Un CNPJ no encontrado, inválido o con falla temporal no consume crédito.
- El límite por minuto se comparte con la Consulta Simple de CPF: 30 solicitudes por minuto por defecto.
Códigos de respuesta
| 200 | CNPJ encontrado. Consume 1 crédito. |
| 400 | CNPJ con formato o dígito verificador incorrecto. No consume crédito. |
| 401 | Clave de API ausente o inválida. |
| 403 | Créditos agotados o cuenta inactiva. |
| 404 | CNPJ no encontrado en la base. No consume crédito. |
| 429 | Límite por minuto excedido. Espera el tiempo del header Retry-After. |
| 503 | Base de CNPJ no disponible en este momento. Inténtalo de nuevo en instantes. No consume crédito. |
Planes
Un solo saldo para CPF y CNPJ.
Empieza con 50 créditos gratis al mes y cambia de plan cuando crezca el volumen.
Gratis
R$ 0
50 créditos al mes, sin tarjeta
SLA 95%
Pro
Desde R$ 19
100 a 10.000 créditos/mes, excedente de R$ 0,19 a R$ 0,10
SLA 99%
Enterprise
A consultar
Más de 10.000 créditos al mes
SLA 99,9%
Preguntas frecuentes
¿Qué datos devuelve la consulta de CNPJ?
Razón social, nombre comercial, situación de registro y su fecha, matriz o sucursal, fecha de inicio de actividad, CNAE principal y secundarios, naturaleza jurídica, dirección, correo y teléfonos, capital social, tamaño de la empresa, opción por el Simples Nacional y el MEI y la lista de socios y administradores (QSA). El CPF del socio persona física siempre viene enmascarado. La respuesta puede incluir campos nuevos con el tiempo: ignora los que tu integración no use.
¿De dónde vienen los datos y cada cuánto se actualizan?
De la base pública del CNPJ publicada por la Receita Federal (la autoridad tributaria federal de Brasil), actualizada cada mes. CPFHub.io no consulta la Receita Federal en tiempo real para CNPJ: los datos reflejan la última base mensual y pueden estar desactualizados hasta la próxima actualización.
¿Cuánto cuesta consultar un CNPJ?
Lo mismo que la Consulta Simple de CPF: 1 crédito por CNPJ encontrado, del mismo saldo del plan, incluidos los 50 créditos mensuales del plan Gratis. Un CNPJ no encontrado (404), inválido (400) o con una falla temporal (503) no consume crédito. Mira /es/precios.
¿Puedo consultar varios CNPJ a la vez?
Sí. La Consulta de CNPJ por Lote recibe hasta 10.000 CNPJ por envío, por la API (POST /cnpj/bulk) o con un archivo CSV en el panel, y solo cobra los CNPJ encontrados.
¿La API acepta el CNPJ alfanumérico?
Sí. Además del CNPJ numérico, la API acepta el formato alfanumérico (12 caracteres con letras y números, más 2 dígitos verificadores), que la Receita Federal empezó a emitir en julio de 2026. Puedes enviarlo con o sin formato.
¿Hay un límite de solicitudes?
Sí. La consulta de CNPJ comparte con la Consulta Simple de CPF el mismo límite por minuto de cada clave de API: 30 solicitudes por minuto por defecto, y cada lote cuenta como 1. Por encima de eso, la API responde 429 con el header Retry-After.
¿Puedo consultar CNPJ sin programar?
Sí. En el dashboard de CPFHub.io, el menú Consultas tiene CNPJ Simple, para un CNPJ a la vez, y CNPJ por Lote, para subir una lista. Las consultas de CPF y de CNPJ aparecen juntas en el Historial.
Consulta tu primer
CNPJ hoy mismo.
- 50 créditos gratis al mes
- Sin tarjeta de crédito
- Atención 24 h por WhatsApp