Consulta de CNPJ por API, com os Dados Abertos da Receita
Envie um CNPJ e receba razão social, situação cadastral, atividade, endereço e sócios em um JSON padronizado. Aceita o CNPJ com ou sem pontuação e já funciona com o novo CNPJ alfanumérico.
Plano gratuito com 20 consultas por mês. Sem cartão de crédito.
Resultado da consulta
- CNPJ
- 12.345.678/0001-95
- Razão social
- Empresa Exemplo Tecnologia Ltda
- Situação
- Ativa
- Atividade principal
- 6201501
O que a consulta devolve
Os dados públicos do cadastro, prontos para validar um cliente, um fornecedor ou um parceiro.
- Identificação
- CNPJ, razão social, nome fantasia, natureza jurídica e capital social, no formato que a Receita usa.
- Situação cadastral
- Ativa, baixada, inapta ou suspensa, com a data da situação e a data de abertura da empresa.
- Atividades e porte
- CNAE principal e secundários, porte da empresa, matriz ou filial e a opção pelo Simples Nacional e pelo MEI, com as datas.
- Endereço
- Logradouro, número, complemento, bairro, cidade, UF e CEP da sede cadastrada, mais o e-mail e os telefones da empresa.
- Quadro societário
- Nome, qualificação, tipo (pessoa física, jurídica ou estrangeiro), CPF parcialmente oculto, faixa etária e data de entrada na sociedade de cada sócio ou administrador.
- Atualização dos dados
- Os dados refletem a última publicação da Receita Federal nos Dados Abertos, com até 30 dias de defasagem.
Como a consulta funciona
- 1
Validação local
Antes de qualquer busca, conferimos o formato e os dígitos verificadores. CNPJ inválido volta com erro 400 e não gasta crédito.
- 2
Resposta rápida
Se o CNPJ já foi consultado recentemente, a resposta sai em milissegundos.
- 3
Dados Abertos da Receita
Quando necessário, buscamos nos Dados Abertos do CNPJ e devolvemos o resultado.
Pronta para o CNPJ alfanumérico
Desde julho de 2026 a Receita Federal emite CNPJs com letras e números. A BrazID já valida e consulta os dois formatos, sem mudança na sua integração.
12.ABC.345/01DE-35
- Como é o novo formato
- 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.
- Validação pelo método oficial
- Calculamos os dígitos verificadores como a Receita define. O CNPJ numérico segue valendo e é conferido do mesmo jeito.
- Entrada flexível
- Com ou sem pontuação, em maiúsculas ou minúsculas. A API normaliza antes de consultar, e a resposta devolve o CNPJ sem pontuação.
- Valide de graça
- A rota POST /v1/validate confere CPF e CNPJ, inclusive o alfanumérico, sem gastar crédito.
Uma chamada, um JSON
Autentique com o cabeçalho x-api-key e passe o CNPJ no caminho. Com ou sem pontuação.
Documentação do endpointcURL GET /v1/cnpj/12345678000195
Resposta
Consulta concluída com sucesso.
CNPJ não encontrado na base da Receita Federal.
Quanto custa
1 crédito por consulta com sucesso
Só a resposta 200 consome crédito. CNPJ inválido (400), não encontrado (404) e indisponibilidade (503) não cobram nada.
Sandbox sem custo
Chaves de sandbox (brz_test_) respondem com dados de teste e nunca debitam saldo. Use para integrar sem gastar créditos.
Mesmo saldo do CPF
Os créditos do plano valem para consultas de CPF e de CNPJ. Passou da franquia, o excedente segue a regra do seu plano.
Onde usar
Cadastro de clientes B2B
Preencha razão social e endereço a partir do CNPJ e recuse empresas baixadas ou inaptas.
Análise de fornecedores e parceiros
Confirme a situação cadastral e o quadro societário antes de fechar contrato.
Enriquecimento de base
Atualize bases de leads e de clientes com atividade, porte da operação e localização.
Perguntas frequentes
De onde vêm os dados do CNPJ?
Dos Dados Abertos do CNPJ, publicados pela Receita Federal. Não é uma consulta em tempo real ao sistema da Receita: os dados refletem a última publicação, com até 30 dias de defasagem.
A API aceita o CNPJ alfanumérico?
Sim. Desde julho de 2026 a Receita emite CNPJs com letras e números. A validação dos dígitos verificadores e a consulta funcionam para os dois formatos.
O que acontece se eu enviar um CNPJ inválido?
A API responde 400 com o erro INVALID_CNPJ_FORMAT, sem consultar nenhuma base e sem gastar crédito. Se quiser só conferir o número, a rota POST /v1/validate é gratuita.
Os dados incluem CPF, e-mail ou telefone dos sócios?
Só em parte. Devolvemos nome, qualificação, faixa etária, data de entrada e o CPF já parcialmente oculto pela Receita (ex.: ***345856**). O CPF completo, e-mails e telefones não fazem parte da resposta.
Quanto custa cada consulta?
Cada resposta 200 consome 1 crédito do seu plano. O plano gratuito inclui 20 créditos por mês, sem cartão. Veja os planos na página de preços.
Valide empresas sem montar planilhas
Crie sua conta, gere uma chave de sandbox e faça a primeira consulta de CNPJ em minutos.
Plano gratuito com 20 consultas por mês. Sem cartão de crédito.