Consulta de CNPJ
Consulta de CNPJ por API,
com situação e sócios.
Envie o CNPJ e receba em JSON a razão social, a situação cadastral, o CNAE, o endereço e o quadro de sócios da empresa. Aceita o CNPJ alfanumérico e usa a mesma chave e o mesmo saldo da consulta de CPF.
50 créditos grátis por mês, sem cartão de crédito. O mesmo saldo vale para CPF e CNPJ.
O que você recebe
O cadastro da empresa em uma resposta.
Os dados públicos do CNPJ organizados em JSON, prontos para gravar no seu sistema.
Identificação e situação cadastral
Razão social, nome fantasia, matriz ou filial, natureza jurídica e a situação cadastral com a data, para saber se a empresa está ativa, baixada, inapta ou suspensa.
razao_socialnome_fantasiasituacao_cadastraldata_situacao_cadastralmatriz_filialnatureza_juridicaAtividade, porte e regime
CNAE principal e secundários, data de abertura, porte, capital social e as opções pelo Simples Nacional e pelo MEI.
cnae_principalcnaes_secundariosdata_inicio_atividadeporte_empresacapital_socialopcao_simplesopcao_meiEndereço e contato
Logradouro, número, bairro, CEP, município e UF do estabelecimento, além do e-mail e dos telefones cadastrados na Receita Federal.
logradourobairrocepmunicipioufemailtelefonesQuadro de sócios (QSA)
Nome, qualificação, data de entrada e faixa etária de cada sócio e administrador. O CPF de sócio pessoa física vem sempre mascarado.
QSAnome_socioqualificacao_sociocnpj_cpf_socioMuitos CNPJs de uma vez? A Consulta de CNPJ em Lote recebe até 10.000 por envio, com os mesmos campos.
Ver todos os campos na documentaçãoComo funciona
Uma chamada GET. Nenhum contrato.
A mesma integração da consulta de CPF, com outra rota.
- 01
Crie a conta
Cadastro self-serve em app.cpfhub.io, sem cartão. A chave de API aparece no painel logo depois.
- 02
Chame GET /cnpj/{cnpj}
Envie o CNPJ com ou sem máscara, numérico ou alfanumérico, com a chave no header x-api-key. O dígito verificador é conferido antes da busca.
- 03
Use o JSON
Grave a razão social, confira a situação cadastral ou preencha o endereço do cliente. CNPJ não encontrado volta 404 e não consome crédito.
Integre em qualquer linguagem
A mesma chave da consulta de CPF, com a rota /cnpj. Exemplos prontos em dez linguagens.
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 grátis por mês, sem cartão.
De onde vêm os dados
Base pública, regras claras.
Você sabe o que está consultando e até onde a resposta vai.
Dados Abertos da Receita Federal
Os dados vêm da base pública do CNPJ publicada pela Receita Federal, atualizada todo mês. Não é consulta em tempo real: a resposta reflete a última base publicada.
CNPJ alfanumérico
A Receita começou a emitir CNPJ com letras em julho de 2026. A API já valida e consulta os dois formatos, com ou sem pontuação.
CPF de sócio mascarado
O CPF de sócio pessoa física nunca volta completo. Você recebe o nome e a qualificação, sem expor o documento.
Onde usar
Onde a empresa precisa ser conferida.
Situações em que um CNPJ errado ou inativo vira prejuízo, nota rejeitada ou retrabalho.
Cadastro de clientes PJ
Confirme que o CNPJ existe e está ativo antes de liberar a conta, o crédito ou o pedido.
Homologação de fornecedores
Confira situação cadastral, CNAE e quadro de sócios antes de assinar o contrato ou pagar a primeira nota.
Formulário que se preenche sozinho
O cliente digita o CNPJ e o formulário completa a razão social e o endereço. Menos digitação, menos erro.
Emissão de nota fiscal
Confira endereço, município e opção pelo Simples Nacional antes de emitir, para não ter nota rejeitada.
Análise de crédito PJ
Data de abertura, porte e capital social ajudam a separar a empresa aberta mês passado da que opera há anos.
Agentes de IA e automações
Uma rota GET com JSON previsível. Seu agente ou sua automação consultam o CNPJ com uma requisição HTTP.
Créditos e códigos
Você só paga pelo CNPJ que existe.
Mesmo custo e mesmo saldo da Consulta Simples de CPF. Erro, CNPJ inválido e CNPJ não encontrado não consomem crédito.
Como o crédito funciona
- 1 crédito por CNPJ encontrado, descontado do mesmo saldo que você usa para CPF.
- Os 50 créditos mensais do plano Grátis também valem para CNPJ.
- CNPJ não encontrado, inválido ou com falha temporária não consome crédito.
- O limite por minuto é dividido com a Consulta Simples de CPF: 30 requisições por minuto no padrão.
Códigos de resposta
| 200 | CNPJ encontrado. Consome 1 crédito. |
| 400 | CNPJ com formato ou dígito verificador incorreto. Não consome crédito. |
| 401 | Chave de API ausente ou inválida. |
| 403 | Créditos esgotados ou conta inativa. |
| 404 | CNPJ não encontrado na base. Não consome crédito. |
| 429 | Limite por minuto excedido. Espere o tempo do header Retry-After. |
| 503 | Base de CNPJ indisponível no momento. Tente de novo em instantes. Não consome crédito. |
Planos
Um saldo só para CPF e CNPJ.
Comece com 50 créditos grátis por mês e mude de plano quando o volume crescer.
Grátis
R$ 0
50 créditos por mês, sem cartão
SLA 95%
Pro
A partir de R$ 19
100 a 10.000 créditos/mês, excedente de R$ 0,19 a R$ 0,10
SLA 99%
Corporativo
Sob consulta
Acima de 10.000 créditos por mês
SLA 99,9%
Perguntas frequentes
Quais dados a consulta de CNPJ retorna?
Razão social, nome fantasia, situação cadastral e a data da situação, matriz ou filial, data de início da atividade, CNAE principal e secundários, natureza jurídica, endereço, e-mail e telefones, capital social, porte, opção pelo Simples Nacional e pelo MEI e o quadro de sócios e administradores (QSA). O CPF de sócio pessoa física vem sempre mascarado. A resposta pode ganhar campos novos com o tempo: ignore os que a sua integração não usar.
De onde vêm os dados e com que frequência são atualizados?
Da base pública do CNPJ publicada pela Receita Federal (Dados Abertos do CNPJ), atualizada mensalmente. A CPFHub.io não consulta a Receita em tempo real para CNPJ: os dados refletem a última base mensal e podem ficar defasados até a próxima atualização.
Quanto custa consultar um CNPJ?
O mesmo que a Consulta Simples de CPF: 1 crédito por CNPJ encontrado, descontado do mesmo saldo do plano, inclusive dos 50 créditos mensais do plano Grátis. CNPJ não encontrado (404), inválido (400) ou com falha temporária (503) não consome crédito. Veja /precos.
Posso consultar vários CNPJs de uma vez?
Sim. A Consulta de CNPJ em Lote recebe até 10.000 CNPJs por envio, pela API (POST /cnpj/bulk) ou por planilha CSV no painel, e cobra só os CNPJs encontrados.
A API aceita o CNPJ alfanumérico?
Sim. Além do CNPJ numérico, a API aceita o formato alfanumérico (12 caracteres com letras e números, mais 2 dígitos verificadores), que a Receita Federal começou a emitir em julho de 2026. Pode enviar com ou sem máscara.
Existe limite de requisições?
Sim. A consulta de CNPJ divide com a Consulta Simples de CPF o mesmo limite por minuto de cada chave de API: 30 requisições por minuto no padrão, e cada lote conta como 1. Acima disso, a API responde 429 com o header Retry-After.
Consigo consultar CNPJ sem programar?
Sim. No painel da CPFHub.io, o menu Consultas tem CNPJ Simples, para um CNPJ por vez, e CNPJ Em Lote, para enviar uma lista. As consultas de CPF e de CNPJ ficam juntas no Histórico.
Consulte o primeiro
CNPJ ainda hoje.
- 50 créditos grátis por mês
- Sem cartão de crédito
- Atendimento 24h no WhatsApp