Consulta de CNPJ

Envie o CNPJ e receba os dados cadastrais da empresa: razão social, nome fantasia, situação cadastral, endereço, CNAE, porte, Simples Nacional/MEI e quadro de sócios (QSA). Custa 1 crédito por CNPJ encontrado, como a Consulta Simples de CPF.

Muitos CNPJs de uma vez? Use a Consulta de CNPJ em Lote. Sem código, o dashboard consulta um CNPJ por vez e guarda o resultado no Histórico.

Endpoint

Parâmetros

CNPJ alfanumérico

A API aceita o novo formato de CNPJ alfanumérico, que a Receita Federal começou a emitir em julho de 2026: 12 caracteres com letras (A a Z) e números, seguidos de 2 dígitos verificadores numéricos. Exemplo fictício: 12ABC34501DE35 (ou 12.ABC.345/01DE-35).

• Letras minúsculas são convertidas para maiúsculas.
• Pontos, barra e traço são removidos antes da validação.
• O dígito verificador é conferido nos dois formatos. Sequências repetidas como 00000000000000 são recusadas.
• Guarde o CNPJ como texto no seu banco, nunca como número.

Exemplo

Os exemplos leem a chave de CPFHUB_API_KEY, tratam o 404 como resultado normal e usam timeout de 10 s.

curl --max-time 10 "https://api.cpfhub.io/cnpj/11222333000181" \
  -H "x-api-key: $CPFHUB_API_KEY"

Resposta

HTTP 200 OK

{
  "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"],
    "codigo_natureza_juridica": "2062",
    "natureza_juridica": "Sociedade Empresária Limitada",
    "tipo_logradouro": "RUA",
    "logradouro": "DAS FLORES",
    "numero": "100",
    "complemento": "SALA 1",
    "bairro": "CENTRO",
    "cep": "01001000",
    "uf": "SP",
    "municipio": "SAO PAULO",
    "email": "contato@example.com",
    "telefones": [
      { "ddd": "11", "numero": "00000000", "is_fax": false }
    ],
    "capital_social": "100000,00",
    "porte_empresa": "Microempresa (ME)",
    "opcao_simples": "S",
    "data_opcao_simples": "2015-03-10",
    "opcao_mei": "N",
    "data_opcao_mei": null,
    "QSA": [
      {
        "nome_socio": "FULANO DE TAL",
        "cnpj_cpf_socio": "***.456.789-**",
        "qualificacao_socio": "Sócio-Administrador",
        "data_entrada_sociedade": "2015-03-10",
        "identificador_socio": "Pessoa Física",
        "faixa_etaria": "31 a 40 anos"
      }
    ]
  }
}

Os campos vêm da base pública do CNPJ e são, em geral, string. Datas usam AAAA-MM-DD. Campo vazio pode vir como "".

Cada item de data.QSA:

• Datas vazias ou 0000-00-00 na base de origem chegam como null.
• A resposta pode ganhar campos novos. Ignore campos que o seu código não conhece.

Erros

Formato do erro e retentativas: Códigos de Erro. Limite por minuto e créditos: Limites de Uso.

Detalhes

• Custo: 1 crédito por CNPJ encontrado (200), o mesmo custo da Consulta Simples de CPF e da mesma franquia do plano. Alguns planos têm custo próprio: consulte o do seu plano no dashboard. 400, 404, 429 e 503 não consomem crédito.
• Limite por minuto: a Consulta de CNPJ e a Consulta Simples de CPF dividem o mesmo limite por API Key (30 requisições por minuto no padrão, somando as duas).
• Fonte dos dados: base pública do CNPJ publicada pela Receita Federal (Dados Abertos do CNPJ), atualizada mensalmente e tratada pelo projeto OpenCNPJ (licença MIT). A CPFHub.io não consulta a Receita em tempo real para CNPJ: um registro pode estar defasado até a próxima atualização mensal. Não existe Consulta em Tempo Real de CNPJ.
• Sócios pessoa física: o CPF do sócio vem sempre mascarado. A API não devolve CPF completo de sócios.
• Histórico: as consultas de CNPJ aparecem no Histórico do dashboard, junto com as de CPF.
• Timeout do cliente: a consulta pode ter sido concluída e cobrada no servidor. Repetir cobra de novo.
• Dados de exemplo: o CNPJ 11222333000181, o CNPJ alfanumérico 12ABC34501DE35 e os dados acima são fictícios.

Atualizado em 15 de outubro de 2026