Consulta CNPJ API: como consultar dados de empresas por integração

A consulta CNPJ API permite integrar um sistema, site, aplicativo, ERP ou plataforma diretamente a uma base de dados para buscar informações de empresas a partir do CNPJ. Em vez de uma pessoa acessar manualmente uma página de consulta e digitar o cadastro da empresa, o próprio software envia uma requisição e recebe os dados de forma estruturada.

Esse tipo de integração pode retornar informações como razão social, nome fantasia, situação cadastral, data de abertura, natureza jurídica, CNAE, endereço e quadro de sócios e administradores, dependendo da API utilizada.

Existe inclusive uma solução oficial de consulta aos dados do CNPJ mantidos pela Receita Federal. A documentação governamental apresenta três modalidades: Consulta Básica, Consulta QSA e Consulta Empresa.

Além disso, desde julho de 2026 existe uma questão técnica particularmente importante: sistemas de consulta precisam estar preparados para o CNPJ alfanumérico. A Receita Federal informou que aplicações que consomem seus serviços por API ou Webservice devem aceitar o novo formato.

O que é uma API de consulta CNPJ?

API é a sigla de Application Programming Interface, ou Interface de Programação de Aplicações.

Na prática, uma API de consulta CNPJ cria uma forma padronizada para que dois sistemas troquem informações.

Imagine uma plataforma que possui um campo chamado “CNPJ”.

O usuário informa seu CNPJ e clica em continuar.

O sistema pode enviar esse identificador para uma API e receber automaticamente informações relacionadas à empresa.

Em vez de exigir que o usuário preencha manualmente razão social, nome fantasia, endereço e CNAE, por exemplo, parte dessas informações pode ser recuperada automaticamente.

Isso torna a consulta CNPJ API útil para cadastros empresariais, sistemas contábeis, ERPs, CRMs, marketplaces e diversas outras aplicações.

Existe API oficial para consultar CNPJ?

Sim.

O catálogo governamental possui uma API Consulta CNPJ associada à Receita Federal.

A documentação oficial informa que a solução disponibiliza três serviços, diferenciados principalmente pela quantidade e pelo tipo de informações retornadas.

São eles:

Consulta CNPJ Básica

Consulta CNPJ QSA

Consulta CNPJ Empresa

A disponibilidade e as condições de acesso dependem da modalidade utilizada.

É importante destacar que a API disponibilizada pelo Conecta para compartilhamento governamental possui regras próprias de acesso. O catálogo informa que o serviço é destinado aos órgãos e entidades abrangidos pelas regras da plataforma.

Já para pessoas jurídicas existe uma solução digital de consulta à base oficial oferecida por meio do serviço correspondente, com condições específicas de contratação.

Como funciona a consulta CNPJ API?

A lógica de uma API é relativamente simples.

O sistema cliente envia uma requisição contendo o CNPJ que deseja consultar.

A API processa essa solicitação.

Se a consulta for válida e autorizada, o servidor devolve uma resposta estruturada, normalmente em um formato apropriado para processamento por software, como JSON.

A aplicação pode então utilizar os dados retornados.

Por exemplo:

Usuário informa CNPJ → sistema consulta API → API retorna dados → sistema preenche cadastro.

Para o usuário final, todo esse processo pode acontecer em poucos segundos.

Quais dados uma API de CNPJ pode retornar?

Depende da modalidade contratada ou utilizada.

Na documentação da API governamental, a consulta básica pode retornar informações como número de inscrição, indicador de matriz ou filial, nome empresarial, nome fantasia, situação cadastral, natureza jurídica, data de abertura, CNAE principal e CNAEs secundários.

Também aparecem campos relacionados a endereço, município, telefone, correio eletrônico, capital social, porte e situação especial.

Isso significa que uma única consulta pode evitar o preenchimento manual de diversos campos.

Entretanto, nem toda API disponível no mercado fornece exatamente as mesmas informações.

Antes de implementar uma integração, é necessário conferir sua documentação.

Consulta CNPJ API Básica

A Consulta CNPJ Básica é apropriada quando o sistema precisa das principais informações cadastrais do estabelecimento.

O serviço oficial descreve entre os dados disponíveis informações como situação cadastral, endereço, atividade econômica, natureza jurídica e telefone.

Essa modalidade pode ser suficiente para sistemas que precisam confirmar a existência do cadastro e preencher informações básicas da empresa.

Um cadastro de fornecedor, por exemplo, pode utilizar esses dados para reduzir erros de digitação.

Consulta CNPJ API QSA

QSA significa Quadro de Sócios e Administradores.

A consulta QSA acrescenta informações societárias à consulta.

O serviço oficial informa que essa modalidade inclui informações da consulta básica, dados do quadro societário e informações relacionadas à opção pelo MEI e pelo Simples.

Essa consulta pode ser particularmente relevante em sistemas que precisam trabalhar com informações societárias.

Entretanto, o tratamento desses dados deve respeitar as regras aplicáveis ao uso e proteção das informações.

Consulta CNPJ API Empresa

A modalidade Consulta Empresa fornece um conjunto ainda mais abrangente de informações.

Segundo a descrição oficial do serviço, ela reúne informações da consulta básica e da consulta QSA, além de dados adicionais previstos para essa modalidade.

Portanto, a escolha entre Básica, QSA e Empresa depende da finalidade da aplicação.

Não existe razão para solicitar um conjunto mais amplo de dados se o sistema necessita apenas confirmar razão social e situação cadastral.

Como fazer consulta CNPJ via API?

Em termos técnicos, uma integração costuma seguir quatro etapas principais:

1. obter acesso à API;
2. autenticar a aplicação;
3. enviar o CNPJ no endpoint correspondente;
4. processar a resposta recebida.

Na API documentada no Conecta, por exemplo, existem endpoints específicos para as consultas Básica, QSA e Empresa.

A autenticação utiliza OAuth2, e a documentação técnica também prevê parâmetros e cabeçalhos necessários para cada requisição.

Portanto, não basta simplesmente colocar o endereço da API no navegador.

A aplicação precisa implementar corretamente autenticação, requisições e tratamento das respostas.

Exemplo de funcionamento de uma consulta CNPJ API

Imagine um sistema de cadastro de fornecedores.

O formulário apresenta o campo:

CNPJ

Depois que o usuário informa o identificador, o sistema envia a consulta.

A resposta pode conter informações equivalentes a:

{
  "cnpj": "CNPJ_CONSULTADO",
  "nomeEmpresarial": "EMPRESA EXEMPLO LTDA",
  "nomeFantasia": "EMPRESA EXEMPLO",
  "situacaoCadastral": "ATIVA",
  "porte": "ME",
  "municipio": "SAO PAULO"
}

Esse exemplo é meramente ilustrativo e não representa necessariamente a estrutura exata de uma API específica.

O desenvolvedor precisa seguir o esquema informado pela documentação da solução escolhida.

Consulta CNPJ API em JavaScript

Em uma aplicação web, uma implementação simplificada poderia seguir uma lógica semelhante a esta:

async function consultarCNPJ(cnpj) {
    const resposta = await fetch(
        `ENDERECO_DA_API/${cnpj}`,
        {
            headers: {
                Authorization: "Bearer TOKEN"
            }
        }
    );

    if (!resposta.ok) {
        throw new Error("Não foi possível consultar o CNPJ");
    }

    return await resposta.json();
}

O código é apenas um exemplo conceitual.

A URL, autenticação, cabeçalhos e parâmetros devem seguir exatamente a documentação da API utilizada.

Também não é recomendável expor credenciais privadas diretamente no JavaScript executado pelo navegador.

Quando uma API utiliza uma chave secreta, normalmente a consulta deve passar pelo backend da aplicação.

Consulta CNPJ API em PHP

A mesma lógica pode ser implementada em PHP:

<?php

$cnpj = "CNPJ_CONSULTADO";
$url = "ENDERECO_DA_API/" . $cnpj;

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer TOKEN"
]);

$resposta = curl_exec($ch);

if ($resposta === false) {
    die("Erro ao realizar a consulta.");
}

curl_close($ch);

$dados = json_decode($resposta, true);

print_r($dados);

Novamente, o código precisa ser adaptado para a API escolhida.

Algumas APIs utilizam OAuth2. Outras podem trabalhar com API Key ou outros mecanismos de autenticação.

Consulta CNPJ API em Python

Em Python, uma implementação conceitual poderia utilizar a biblioteca requests:

import requests

cnpj = "CNPJ_CONSULTADO"

url = f"ENDERECO_DA_API/{cnpj}"

headers = {
    "Authorization": "Bearer TOKEN"
}

response = requests.get(url, headers=headers)

response.raise_for_status()

dados = response.json()

print(dados)

A lógica continua sendo a mesma independentemente da linguagem:

enviar CNPJ → receber resposta → interpretar JSON → utilizar os dados.

Consulta CNPJ API gratuita existe?

Existem diferentes soluções de consulta no mercado, incluindo serviços que oferecem planos gratuitos, limites de requisições ou períodos de teste.

Entretanto, “API gratuita” não significa necessariamente acesso ilimitado à base oficial em tempo real.

No serviço oficial destinado a pessoas jurídicas, a página do Governo Federal informa atualmente a possibilidade de utilização gratuita por até 30 dias ou 3.000 consultas, condicionada às regras do período de demonstração; depois dos limites aplicáveis, o serviço é cobrado.

Por isso, antes de escolher uma API, verifique:

origem dos dados, frequência de atualização, limite de requisições, disponibilidade, licença de uso, preço e campos retornados.

API CNPJ da Receita Federal é gratuita?

Não se deve generalizar.

Existem diferentes formas de acesso aos dados do CNPJ.

A API do ambiente Conecta possui regras de compartilhamento específicas para a Administração Pública.

Para empresas, o serviço de solução digital de consulta possui condições próprias. A página oficial informa a existência de período ou franquia demonstrativa e cobrança quando os limites aplicáveis são ultrapassados. Também informa a necessidade de e-CNPJ da contratante para contratação.

Portanto, quem deseja implementar uma API comercial deve verificar qual modalidade atende ao seu caso.

Dados abertos do CNPJ são uma alternativa à API?

Sim, dependendo do projeto.

A Receita Federal também mantém Dados Abertos do CNPJ entre os conjuntos disponibilizados publicamente.

Essa abordagem é diferente de uma API de consulta individual.

Em uma API, normalmente o sistema pergunta:

“Quais são os dados deste CNPJ?”

Em uma base de dados aberta, a aplicação pode importar grandes conjuntos de registros e construir sua própria infraestrutura de pesquisa.

Isso pode ser interessante para projetos que realizam um volume elevado de consultas.

Em contrapartida, manter uma base própria exige processamento, armazenamento, atualização e infraestrutura.

Consulta manual ou consulta CNPJ API?

Para consultar uma empresa ocasionalmente, provavelmente não existe necessidade de desenvolver uma integração.

O Governo Federal possui serviço oficial de consulta CNPJ, que permite consultar informações cadastrais e emitir o comprovante de inscrição e situação cadastral. O serviço também permite acessar informações do QSA.

Consultar CNPJ no serviço oficial do Governo Federal

A API faz mais sentido quando a consulta precisa acontecer automaticamente dentro de outro sistema.

Por exemplo, uma plataforma que recebe centenas de novos fornecedores por dia pode ganhar produtividade preenchendo dados automaticamente.

Como escolher uma API de consulta CNPJ?

O primeiro ponto é verificar a origem das informações.

Depois, analise a atualização da base.

Também verifique quais campos são retornados.

Uma aplicação pode precisar somente de razão social e situação cadastral, enquanto outra pode necessitar CNAEs, endereço e informações societárias.

Outro aspecto fundamental é a disponibilidade.

Se o cadastro de clientes depende da API, uma indisponibilidade do serviço pode afetar diretamente a operação.

Por isso, aplicações críticas devem prever tratamento de erros, tempo limite e mecanismos apropriados para indisponibilidades temporárias.

Consulta CNPJ API e situação cadastral

Um dos campos mais úteis é a situação cadastral.

Ela permite ao sistema identificar a situação registrada para aquele estabelecimento no CNPJ.

Entretanto, situação cadastral não deve ser confundida com avaliação comercial.

Uma empresa constar como ativa no CNPJ não significa automaticamente que seja financeiramente saudável, confiável ou sem dívidas.

A API está retornando uma informação cadastral.

Análises de crédito, risco e compliance podem exigir fontes e procedimentos adicionais.

Consulta CNPJ API e CNAE

Outro campo bastante utilizado é o CNAE — Classificação Nacional de Atividades Econômicas.

A consulta pode retornar o CNAE principal e, dependendo da modalidade, atividades secundárias.

Isso permite automatizar classificações internas.

Uma plataforma B2B poderia, por exemplo, utilizar o CNAE para organizar clientes por segmento.

Um sistema contábil também pode aproveitar essas informações durante determinados processos cadastrais.

Entretanto, o CNAE retornado representa aquilo que consta no cadastro. O sistema não deve presumir que somente esse dado é suficiente para determinar todas as características tributárias da empresa.

Consulta CNPJ API e quadro societário

Quando a modalidade utilizada disponibiliza QSA, a aplicação pode acessar informações relacionadas ao Quadro de Sócios e Administradores.

Isso é útil para diversos processos empresariais.

Porém, quanto maior a quantidade de dados processados, maior deve ser o cuidado com finalidade, segurança e governança.

Não é recomendável coletar e armazenar grandes volumes de informações simplesmente porque a API consegue fornecê-las.

O sistema deve buscar os dados necessários à finalidade legítima da aplicação.

API CNPJ e LGPD

A utilização de uma API de CNPJ também pode envolver questões relacionadas à proteção de dados.

Informações empresariais podem estar associadas a pessoas físicas, principalmente quando são consultados dados societários ou de empresários individuais.

Por isso, aplicações que armazenam e processam essas informações precisam considerar a Lei Geral de Proteção de Dados (LGPD) quando aplicável.

É importante avaliar finalidade, necessidade, segurança, retenção e acesso aos dados.

O fato de determinada informação ser consultável publicamente não significa que qualquer forma de tratamento seja automaticamente adequada para qualquer finalidade.

Consulta CNPJ API e CNPJ alfanumérico

Desde julho de 2026, este é um dos pontos mais importantes para qualquer nova integração.

A Receita Federal implantou o CNPJ alfanumérico para novas inscrições. Os CNPJs existentes permaneceram com seus identificadores numéricos, enquanto novas inscrições passaram a poder utilizar o novo formato.

Isso significa que um sistema moderno não deve presumir que CNPJ seja sempre composto exclusivamente por números.

A Receita Federal alertou especificamente que sistemas externos com integrações por Webservices/API precisam estar preparados para receber CNPJs no formato alfanumérico.

Como adaptar uma API para CNPJ alfanumérico?

Uma das primeiras mudanças é revisar a validação do campo.

Um código antigo pode possuir uma regra semelhante a:

if (!/^d{14}$/.test(cnpj)) {
    return "CNPJ inválido";
}

Essa expressão aceita exclusivamente 14 números.

Portanto, ela pode rejeitar um CNPJ alfanumérico válido.

Também é necessário verificar banco de dados, APIs internas e integrações externas.

Um campo armazenado como número precisa ser revisto.

O CNPJ deve ser tratado como identificador, e não como valor utilizado em operações matemáticas.

A própria Receita Federal disponibilizou orientações e recursos específicos para adaptação ao novo formato.

Erros comuns em uma consulta CNPJ API

Um erro comum é confiar somente no número de caracteres para validar o CNPJ.

Outro é não tratar respostas de erro.

Na API oficial documentada, por exemplo, aparecem respostas diferentes para CNPJ inválido, falta de autorização, registro não encontrado e problemas internos ou de comunicação.

A aplicação precisa saber o que fazer em cada situação.

Também é importante não armazenar tokens ou chaves secretas diretamente no frontend.

Outro problema é realizar consultas desnecessárias.

Se milhares de usuários visualizam repetidamente a mesma empresa, dependendo dos termos da API e da necessidade de atualização, uma estratégia apropriada de cache pode reduzir chamadas e custos.

Perguntas frequentes sobre consulta CNPJ API

Existe API para consultar CNPJ?

Sim. Existem soluções oficiais e privadas. A Receita Federal possui serviços de consulta aos dados do CNPJ, incluindo modalidades Básica, QSA e Empresa.

Existe API CNPJ gratuita?

Existem diferentes opções e modelos de acesso. O serviço oficial para pessoas jurídicas informa atualmente uma demonstração gratuita limitada por período ou quantidade de consultas, sujeita às condições apresentadas no serviço.

O que uma API de CNPJ retorna?

Pode retornar razão social, nome fantasia, situação cadastral, data de abertura, natureza jurídica, CNAEs, endereço e outros dados. Os campos dependem da modalidade utilizada.

A API pode consultar os sócios?

Existem modalidades que disponibilizam informações do QSA — Quadro de Sócios e Administradores.

Posso consultar CNPJ sem API?

Sim. Para consultas individuais, existe o serviço oficial de consulta do CNPJ disponibilizado pelo Governo Federal.

API de CNPJ precisa aceitar letras?

Sim, sistemas atualizados precisam estar preparados para o CNPJ alfanumérico. A Receita Federal alertou que integrações via API e Webservices devem ser adaptadas ao novo formato.

Os CNPJs antigos deixaram de funcionar?

Não. A Receita Federal informa que os CNPJs já existentes permanecem válidos e não têm seus números alterados pela adoção do modelo alfanumérico.

Conclusão

A consulta CNPJ API é uma solução importante para sistemas que precisam consultar automaticamente informações empresariais. Ela pode ser utilizada em cadastros de clientes e fornecedores, ERPs, sistemas contábeis, plataformas B2B, CRMs e diversas outras aplicações.

A Receita Federal possui soluções oficiais de consulta, e a documentação governamental apresenta modalidades Básica, QSA e Empresa, com diferentes conjuntos de informações.

Para uma consulta ocasional, o serviço manual oficial pode ser suficiente. Para operações automatizadas e de maior escala, uma API ou uma infraestrutura construída a partir dos dados abertos pode ser mais apropriada.

Além disso, qualquer implementação feita atualmente precisa considerar o CNPJ alfanumérico. A Receita Federal já colocou o novo formato em produção em 2026 e alertou que aplicações integradas por API precisam estar adaptadas.

Assim, uma boa integração não deve apenas consultar um CNPJ. Ela precisa validar corretamente os novos identificadores, proteger credenciais, tratar indisponibilidades, respeitar a finalidade do tratamento dos dados e utilizar uma fonte adequada às necessidades do sistema.

“`html “`