Consulta CNPJ — Receita Federal

Consulte qualquer empresa brasileira pelo CNPJ e obtenha o registro completo direto da Receita Federal: razão social, endereço, atividades, quadro societário, regime tributário e muito mais — tudo em JSON estruturado, pronto para integrar com o seu sistema.

---

O que este Actor faz

Recebe um CNPJ, consulta a fonte oficial e devolve o cadastro completo da empresa em um único objeto JSON. Os dados incluem situação cadastral, endereço detalhado, sócios com qualificação e faixa etária, CNAEs principal e secundários, natureza jurídica, capital social, dados de contato, e flags de Simples Nacional e MEI.

---

Para quem é útil

Times de vendas B2B — enriqueça seu CRM com dados cadastrais atualizados sem depender de fornecedores externos caros.

Fintechs e provedores de KYC — valide o CNPJ de um cliente em tempo real e capture o quadro societário para análise de risco e conformidade com normas de prevenção à lavagem de dinheiro.

Consultorias tributárias — identifique de imediato o regime tributário da empresa (Simples Nacional, Lucro Presumido, Lucro Real) e sua situação junto à Receita.

Seguradoras e provedores de crédito — pré-preencha formulários de subscrição com data de abertura, capital social, porte e sócios sem custo por chamada de API externa.

Pesquisadores e jornalistas — acesse o quadro societário completo com CPFs parcialmente mascarados (conforme publicação oficial da Receita Federal).

---

Input

Informe apenas o CNPJ desejado. Formatação é opcional — pontos, barras e traços são ignorados automaticamente.

{
  "cnpj": "00000000000191"
}

Campo	Tipo	Obrigatório	Descrição
cnpj	string	Sim	CNPJ com 14 dígitos. Aceita formatado (00.000.000/0001-91) ou apenas números.

---

Output

O Actor devolve um array com um objeto contendo o cadastro completo da empresa. Veja um exemplo real com o Banco do Brasil:

[
  {
    "status": "OK",
    "consultado_em": "2026-06-18T01:57:25.942Z",
    "fonte": "RECEITA FEDERAL",
    "cnpj": "00.000.000/0001-91",
    "cnpj_numerico": "00000000000191",
    "abertura": "01/08/1966",
    "situacao": "ATIVA",
    "data_situacao": "03/11/2005",
    "motivo_situacao": "SEM MOTIVO",
    "situacao_especial": null,
    "data_situacao_especial": null,
    "tipo": "MATRIZ",
    "nome": "BANCO DO BRASIL SA",
    "fantasia": "DIRECAO GERAL",
    "porte": "DEMAIS",
    "capital_social": "120000000000.00",
    "natureza_juridica": {
      "codigo": "203-8",
      "descricao": "Sociedade de Economia Mista",
      "texto": "203-8 - Sociedade de Economia Mista"
    },
    "atividade_principal": [
      { "code": "64.22-1-00", "text": "Bancos múltiplos, com carteira comercial" }
    ],
    "atividades_secundarias": [
      { "code": "64.99-9-99", "text": "Outras atividades de serviços financeiros não especificadas anteriormente" }
    ],
    "endereco": {
      "logradouro": "QUADRA SAUN QUADRA 5 BLOCO B TORRE I, II, III",
      "numero": "SN",
      "complemento": "ANDAR T I SL S101 A S1602",
      "bairro": "ASA NORTE",
      "municipio": "BRASILIA",
      "uf": "DF",
      "cep": "70.040-912"
    },
    "contato": {
      "email": "secex@bb.com.br",
      "telefone": "(61) 34939002",
      "telefones": ["(61) 34939002"]
    },
    "simples": {
      "optante": false,
      "data_opcao": "01/07/2007",
      "data_exclusao": "01/07/2007",
      "ultima_atualizacao": "2026-06-18T01:57:25.942Z"
    },
    "simei": {
      "optante": false,
      "data_opcao": "01/07/2009",
      "data_exclusao": "01/07/2009",
      "ultima_atualizacao": "2026-06-18T01:57:25.942Z"
    },
    "socios": [
      {
        "nome": "TARCIANA PAULA GOMES MEDEIROS",
        "cpf_cnpj": "***128734**",
        "tipo": "PJ",
        "qualificacao": "Presidente",
        "data_entrada": "26/01/2023",
        "faixa_etaria": 5
      }
    ],
    "ultima_atualizacao": "2026-06-18T01:57:25.942Z"
  }
]

---

Campos do Output

Identificação

Campo	Tipo	Descrição
status	string	OK quando a consulta teve sucesso.
fonte	string	Origem dos dados (RECEITA FEDERAL).
cnpj	string	CNPJ formatado com máscara.
cnpj_numerico	string	CNPJ apenas com os 14 dígitos.
nome	string	Razão social da empresa.
fantasia	string	Nome fantasia (DBA).
tipo	string	MATRIZ ou FILIAL.
porte	string	Porte da empresa: MICRO EMPRESA, EPP ou DEMAIS.
capital_social	string	Capital social declarado em reais.

Situação Cadastral

Campo	Tipo	Descrição
situacao	string	ATIVA, SUSPENSA, INAPTA, BAIXADA ou NULA.
data_situacao	string	Data em que a situação atual entrou em vigor.
motivo_situacao	string	Motivo da situação cadastral.
situacao_especial	string|null	Situação especial, quando aplicável.
data_situacao_especial	string|null	Data da situação especial.
abertura	string	Data de abertura da empresa.

Atividades

Campo	Tipo	Descrição
atividade_principal	array	CNAE principal com código e descrição.
atividades_secundarias	array	Lista de CNAEs secundários com código e descrição.
natureza_juridica	object	Código, descrição e texto formatado da natureza jurídica.

Endereço

Campo	Tipo	Descrição
endereco.logradouro	string	Tipo e nome do logradouro.
endereco.numero	string	Número.
endereco.complemento	string	Complemento (sala, andar, bloco).
endereco.bairro	string	Bairro.
endereco.municipio	string	Município.
endereco.uf	string	Estado (sigla de 2 letras).
endereco.cep	string	CEP formatado.

Contato

Campo	Tipo	Descrição
contato.email	string	E-mail informado à Receita Federal.
contato.telefone	string	Telefone principal com DDD.
contato.telefones	array	Lista de todos os telefones cadastrados.

Regime Tributário

Campo	Tipo	Descrição
simples.optante	boolean	true se a empresa é optante do Simples Nacional.
simples.data_opcao	string	Data de adesão ao Simples Nacional.
simples.data_exclusao	string	Data de exclusão do Simples Nacional.
simei.optante	boolean	true se é MEI (Microempreendedor Individual).
simei.data_opcao	string	Data de adesão ao SIMEI.
simei.data_exclusao	string	Data de exclusão do SIMEI.

Quadro Societário (QSA)

O campo socios é um array de objetos. Cada sócio contém:

Campo	Tipo	Descrição
nome	string	Nome completo do sócio ou administrador.
cpf_cnpj	string	CPF mascarado no formato ***123456** (conforme publicado pela Receita Federal) ou CNPJ da empresa sócia.
tipo	string	PF (pessoa física) ou PJ (pessoa jurídica).
qualificacao	string	Cargo ou qualificação (ex.: Diretor, Presidente, Sócio-Administrador).
data_entrada	string	Data de entrada no quadro societário.
faixa_etaria	integer	Faixa etária codificada pela Receita Federal (1 a 9).

---

Perguntas Frequentes

Os CPFs dos sócios ficam expostos? Não. A própria Receita Federal publica os CPFs parcialmente mascarados no formato ***123456**. O Actor retorna exatamente o que consta na fonte oficial, sem qualquer dado sensível adicional.

Com que frequência os dados são atualizados? Os dados refletem o cadastro da Receita Federal, que é atualizado de forma contínua. Alterações como mudança de situação cadastral, troca de sócios e atualização de endereço são refletidas conforme a empresa as reporta ao órgão.

Funciona para qualquer CNPJ do Brasil? Sim. Todos os mais de 55 milhões de CNPJs registrados na Receita Federal podem ser consultados, incluindo empresas ativas, baixadas, inaptas e suspensas.

Preciso de proxy ou navegador headless? Não. O Actor opera via API JSON pura, sem automação de browser, sem captcha e sem necessidade de proxy.

E se o CNPJ não existir ou estiver inválido? O Actor retorna um objeto com status indicando o erro, sem interromper a execução ou gerar custos adicionais.