Consulta de CNPJ

Devuelve los datos de registro de una empresa a partir de su CNPJ: razón social, situación, actividad principal, dirección, capital social, correo, teléfonos y socios. La fuente son los Datos Abiertos del CNPJ de la Receita Federal, con hasta 30 días de desfase.

Parámetro de la ruta

cnpjpathobligatorio

CNPJ de 14 caracteres, con o sin puntuación. Se acepta el CNPJ alfanumérico.

Solo la respuesta 200 cobra 1 crédito, del mismo saldo de las consultas de CPF. En el sandbox no se cobra nada.

• CNPJ alfanumérico: desde julio de 2026 la Receita emite CNPJ con letras y números. Tienen 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. La API acepta ambos formatos con o sin puntuación, convierte las letras a mayúsculas y calcula los dígitos verificadores con el método oficial (cada letra vale su código ASCII menos 48, con el mismo módulo 11). El CNPJ numérico sigue vigente, y POST /v1/validate también comprueba el formato alfanumérico.
• Las verificaciones se hacen en este orden: formato y dígitos verificadores (400 con el error INVALID_CNPJ_FORMAT), saldo (402) y, al final, la consulta (Datos Abiertos).
• Los datos reflejan la última publicación de la Receita, con hasta 30 días de desfase, y no son una consulta en tiempo real a su sistema.
• La respuesta tiene el mismo formato que las demás consultas: success, data (todos los campos de la empresa) y credits_remaining (si el toggle está activado en el panel). Los nombres de abajo están dentro de data. status puede ser ATIVA, BAIXADA, INAPTA, SUSPENSA o NULA. trade_name es null cuando la empresa no tiene nombre de fantasía. share_capital es el capital social en reales (un número), email es el correo registrado de la empresa (o null) y phones lista los teléfonos de la empresa con area_code, number e is_fax. partners trae nombre, calificación, document (documento ya parcialmente oculto por la fuente), age_range y joined_at (fecha de ingreso en la sociedad); no se devuelven correo ni teléfono de los socios. branch_type (MATRIZ o FILIAL), company_size (tamaño, como lo informa la Receita), secondary_cnaes (actividades secundarias, con code y text), simples y mei (cada uno con opted: true, false o null si la fuente no informa, opted_at y excluded_at) y address.complement completan el registro. En partners, identifier_type es INDIVIDUAL, COMPANY o FOREIGN. Las empresas consultadas antes de la actualización pueden no traer los campos más nuevos por hasta 30 días.
• Un CNPJ sin registro responde 404 con el código CNPJ_NOT_FOUND. Si la fuente no está disponible, la respuesta es 503. En ambos casos no se cobra nada.
• En el sandbox, estos CNPJ tienen datos: 12345678000195 (empresa activa con socio), 11222333000181 (empresa activa sin nombre de fantasía), 11444777000161 (empresa dada de baja), 12ABC34501DE35 (alfanumérico) y 00000000000191 (responde 503). Cualquier otro CNPJ válido responde 404.