Consulta de CNPJ

Devolve os dados cadastrais de uma empresa a partir do CNPJ: razão social, situação, atividade principal, endereço, capital social, e-mail, telefones e sócios. A fonte são os Dados Abertos do CNPJ da Receita Federal, com até 30 dias de defasagem.

Parâmetro do caminho

cnpjpathobrigatório

CNPJ com 14 caracteres, com ou sem pontuação. Aceita o CNPJ alfanumérico.

Só a resposta 200 cobra 1 crédito, o mesmo saldo das consultas de CPF. No sandbox nada é cobrado.

• CNPJ alfanumérico: desde julho de 2026 a Receita emite CNPJs com letras e números. São 14 caracteres: os 12 primeiros podem ser letras (A a Z) ou dígitos, e os 2 últimos são sempre dígitos verificadores. Exemplo: 12.ABC.345/01DE-35. A API aceita os dois formatos com ou sem pontuação, converte as letras para maiúsculas e calcula os dígitos verificadores pelo método oficial (cada letra vale seu código ASCII menos 48, com o mesmo módulo 11). O CNPJ numérico continua valendo, e POST /v1/validate também confere o formato alfanumérico.
• A ordem das verificações é: formato e dígitos verificadores (400 com o erro INVALID_CNPJ_FORMAT), saldo (402) e, por fim, a consulta (Dados Abertos).
• Os dados refletem a última publicação da Receita, com até 30 dias de defasagem, e não são uma consulta em tempo real ao sistema dela.
• A resposta tem o mesmo formato das demais consultas: success, data (todos os campos da empresa) e credits_remaining (se o toggle estiver ligado no painel). Os nomes abaixo estão dentro de data. status pode ser ATIVA, BAIXADA, INAPTA, SUSPENSA ou NULA. trade_name é null quando a empresa não tem nome fantasia. share_capital é o capital social em reais (número), email é o e-mail cadastrado da empresa (ou null) e phones lista os telefones da empresa com area_code, number e is_fax. partners traz nome, qualificação, document (CPF já parcialmente oculto pela fonte), age_range e joined_at (data de entrada na sociedade); e-mail e telefone dos sócios não são devolvidos. branch_type (MATRIZ ou FILIAL), company_size (porte, como a Receita informa), secondary_cnaes (atividades secundárias, com code e text), simples e mei (cada um com opted: true, false ou null quando a fonte não informa, opted_at e excluded_at) e address.complement completam o cadastro. Em partners, identifier_type indica INDIVIDUAL, COMPANY ou FOREIGN. Empresas consultadas antes da atualização podem não trazer os campos mais novos por até 30 dias.
• CNPJ sem registro responde 404 com o código CNPJ_NOT_FOUND. Se a fonte estiver indisponível, a resposta é 503. Em ambos os casos nada é cobrado.
• No sandbox, estes CNPJs têm dados: 12345678000195 (empresa ativa com sócio), 11222333000181 (empresa ativa sem nome fantasia), 11444777000161 (empresa baixada), 12ABC34501DE35 (alfanumérico) e 00000000000191 (responde 503). Qualquer outro CNPJ válido responde 404.