API Consulta CNPJ

Dados Empresariais

Acesse os dados disponibilizados pela receita federal referentes aos CNPJs existentes no Brasil

Sobre esta API

API para consulta e pesquisa de dados cadastrais de empresas, estabelecimentos e sócios a partir da base de CNPJ.

Recursos disponíveis:

  • Consultar um CNPJ completo.
  • Consultar estabelecimentos de uma empresa por CNPJ raiz.
  • Consultar sócios de uma empresa por CNPJ raiz.
  • Pesquisar CNPJs utilizando múltiplos filtros (localização, cnae, situação, simples, mei).
  • Consultar os filtros disponíveis para pesquisa.
  • Consultar os domínios utilizados pelos filtros e dados cadastrais.
  • Consultar códigos e descrições de CNAEs.

A API foi estruturada para permitir tanto consultas pontuais por CNPJ quanto pesquisas segmentadas da base cadastral.

Casos de uso

A API pode ser utilizada para diferentes aplicações de dados empresariais, incluindo:

Prospecção B2B

Identifique empresas utilizando critérios cadastrais, geográficos, econômicos e de atividade.

Segmentação de empresas

Crie segmentos de empresas por:

  • Estado.
  • Situação cadastral.
  • CNAE.
  • Natureza jurídica.
  • Porte.
  • Matriz ou filial.
  • Outros filtros disponibilizados pela API.
Enriquecimento cadastral

Utilize os dados de CNPJ para complementar cadastros internos com informações de empresas, estabelecimentos e sócios.

Validação cadastral

Consulte informações de um CNPJ específico antes de processos de:

  • Cadastro.
  • Onboarding.
  • Análise de clientes.
  • Relacionamento B2B.
  • Integrações de dados.
Inteligência comercial

Combine filtros de atividade econômica e localização para identificar empresas com características específicas.

Análise de empresas

Consulte informações estruturadas sobre empresas, estabelecimentos, atividades econômicas e composição societária.

Estratégia recomendada de uso

Para uma consulta individual, utilize diretamente:

GET /CNPJ/{cnpj}

Para aplicações que precisam realizar pesquisas dinâmicas, recomenda-se utilizar os endpoints na seguinte sequência:

  1. Consultar os filtros disponíveis

    GET /CNPJ/searchFilters

  2. Consultar os domínios necessários

    GET /CNPJ/searchFilters/domains

  3. Consultar CNAEs, quando necessário

    GET /CNPJ/cnae

  4. Executar a pesquisa

    POST /CNPJ/search

  5. Percorrer as páginas

    Continuar incrementando pagina até que a API retorne zero registros.

Dados disponíveis

Os recursos da API permitem trabalhar com diferentes níveis do cadastro empresarial.

Empresa

Os dados da empresa incluem:

  • CNPJ raiz.
  • Razão social.
  • Capital social.
  • Ente federativo, quando aplicável.
  • Porte da empresa.
  • Natureza jurídica.
  • Qualificação do responsável.

Estabelecimento

Os dados de estabelecimento incluem:

  • CNPJ completo.
  • Nome fantasia.
  • Datas cadastrais.
  • Endereço.
  • CEP.
  • Município.
  • País.
  • UF.
  • Telefones.
  • Fax.
  • E-mail.
  • Situação cadastral.
  • Motivo da situação cadastral.
  • Matriz ou filial.
  • CNAE principal.
  • CNAEs secundários.

Sócios

Os dados de sócios incluem:

  • CNPJ raiz da empresa.
  • Nome ou razão social.
  • CPF ou CNPJ do sócio.
  • Data de entrada na sociedade.
  • Representante legal.
  • Nome do representante legal.
  • Identificação do sócio.
  • Qualificação do sócio.
  • País.
  • Faixa etária.

Simples Nacional e MEI

A consulta completa de CNPJ também contempla informações relacionadas ao enquadramento da empresa nos regimes:

  • Simples Nacional.
  • MEI.

São disponibilizadas as datas de opção e exclusão de cada regime.

Principais capacidades

1. Consulta completa por CNPJ

Consulte os dados completos de um CNPJ informado.

Endpoint

GET /CNPJ/{cnpj}

A resposta inclui:

  • Dados da empresa.
  • Estabelecimentos.
  • Dados do Simples Nacional e MEI.
  • Sócios.

O CNPJ pode ser informado com ou sem máscara.

Exemplo

GET /CNPJ/12.345.678/0001-90
2. Consulta de estabelecimentos por CNPJ raiz

Consulte os estabelecimentos vinculados a uma empresa utilizando os oito primeiros dígitos do CNPJ.

Endpoint

GET /CNPJ/raiz/{cnpjRaiz}/filiais

A consulta possui paginação por:

  • PageNumber
  • PageSize

Os resultados contém informações como:

  • CNPJ completo.
  • Nome fantasia.
  • Município.
  • Dados cadastrais e de localização.
  • Situação cadastral.
  • CNAE principal e CNAEs secundários.

Exemplo

GET /CNPJ/raiz/12345678/filiais?PageNumber=1&PageSize=10
3. Consulta de sócios por CNPJ raiz

Consulte os sócios vinculados a uma empresa.

Endpoint

GET /CNPJ/raiz/{cnpjRaiz}/socios

A consulta possui paginação por:

  • PageNumber
  • PageSize

Os dados incluem:

  • Nome ou razão social do sócio.
  • CPF ou CNPJ do sócio.
  • Data de entrada na sociedade.
  • Qualificação do sócio.
  • Identificação do sócio.
  • Representante legal.
  • País.
  • Faixa etária.

Exemplo

GET /CNPJ/raiz/12345678/socios?PageNumber=1&PageSize=10

4. Pesquisa avançada de CNPJs

O endpoint de pesquisa permite consultar CNPJs utilizando um conjunto de filtros permitidos.

Endpoint

POST /CNPJ/search

Os filtros são enviados no corpo da requisição e a paginação é informada na query string.

Exemplo

POST /CNPJ/search?pagina=1&registrosPorPagina=10
Content-Type: application/json

{
  "cod_estado": "56",
  "situacao": "2",
  "cnae": "1113502"
}

Esse exemplo representa uma pesquisa por empresas:

  • do estado de São Paulo;
  • em determinada situação cadastral;
  • associadas ao CNAE informado.
Paginação

A pesquisa utiliza:

  • pagina: número da página, iniciando em 1.
  • registrosPorPagina: quantidade de registros por página, entre 1 e 100.

A pesquisa não retorna o total global de registros da base. Para percorrer os resultados, avance as páginas até que a API retorne uma página com zero registros.

Validação dos filtros

A API valida os filtros enviados. Caso seja solicitado um filtro não permitido, a requisição retorna HTTP 400.

5. Descoberta dos filtros disponíveis

Antes de construir uma pesquisa, é possível consultar os filtros aceitos pelo endpoint /CNPJ/search.

Endpoint

GET /CNPJ/searchFilters

Esse recurso permite descobrir as chaves que podem ser utilizadas no corpo da requisição de pesquisa e a forma esperada para cada filtro.

Isso facilita a construção dinâmica de aplicações que utilizam a API.

6. Consulta dos domínios dos filtros

Consulte os valores de domínio utilizados pelos filtros e pelos dados cadastrais de CNPJ.

Endpoint

GET /CNPJ/searchFilters/domains

Entre os domínios disponibilizados estão:

  • Situação cadastral.
  • Motivo da situação cadastral.
  • Natureza jurídica.
  • Qualificação de sócio.
  • Porte da empresa.
  • Identificação do sócio.
  • Faixa etária do sócio.
  • Matriz ou filial.

Esse endpoint pode ser utilizado para montar listas de seleção e filtros em aplicações consumidoras da API.

7. Consulta de CNAEs

Consulte os códigos e descrições de CNAEs disponíveis.

Endpoint

GET /CNPJ/cnae

A consulta suporta:

  • Paginação.
  • Busca por código.
  • Busca por descrição.
Parâmetros

| Parâmetro | Descrição | Padrão | |---|---|---:| | pagina | Número da página | 1 | | registrosPorPagina | Quantidade de registros por página | 100 | | searchTerm | Termo utilizado para pesquisar código ou descrição | — |

Exemplo por descrição

GET /CNPJ/cnae?searchTerm=milho

Retorna CNAEs cuja descrição contenha o termo pesquisado.

Exemplo por código

GET /CNPJ/cnae?searchTerm=1113

Retorna CNAEs cujo código contenha o termo pesquisado.

Documentação