Documentação Técnica

Consulta de CNPJ na Receita Federal

Descrição

A consulta de CNPJ na Receita Federal retorna o resultado da consulta do comprovante de inscrição e situação cadastral do CNPJ, disponível no site da Receita Federal, incluindo todas as informações contidas no cartão CNPJ no momento da consulta. Não são retornados os dados referentes ao QSA (quadro societário-administrativo) da empresa. Todos os dados de certidões e certificações consultados em um modelo "on-demand" são retornados em uma mesma estrutura de objetos, e os objetos em si são retornados no campo de OnlineCertificates do objeto principal de retorno.

Origem da Informação

As informações retornadas nesta consulta são retiradas da consulta pública de status do CNPJ no site da Receita Federal.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,030
10001 - 50000R$ 0,028
50001 - 100000R$ 0,027
100001 - 500000R$ 0,026
500001 - 1000000R$ 0,025
1000001 - 5000000R$ 0,024
5000001 - 10000000R$ 0,023
10000001 - 50000000R$ 0,022
50000001 e acimaR$ 0,021

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCNPJ🛑 Obrigatório

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "ondemand_rf_status_company",
    "q": "doc{CNPJ}"  
}  

Atenção

Não recomendamos a utilização dessa consulta, uma vez que a base de CNPJs da BigData Corp. é atualizada mensalmente tanto com novos CNPJs quanto com o status dos CNPJs já existentes, minimizando assim a possibilidade de informações defasadas. Recomendamos que seja utilizado, em seu lugar, o dataset de Dados Cadastrais Básicos.

Descrição dos campos do objeto principal de retorno

CampoDescrição
OriginFonte dos Dados Entregues
InputParametersParâmetros de entrada
ProtocolNumberNúmero de protocolo da certidão
BaseStatusSituação cadastral pela certidão
AdditionalOutputData.OfficialNameRazão Social da empresa
AdditionalOutputData.BusinessNameNome fantasia da empresa
AdditionalOutputData.FoundingDateData de fundação da empresa
AdditionalOutputData.FederalEntityEnte Federativo Responsável
AdditionalOutputData.CompanyTypeTipo do Estabelecimento (MATRIZ ou FILIAL)
AdditionalOutputData.CnaeCódigo da atividade principal
AdditionalOutputData.MainEconomicActivityAtividade principal
AdditionalOutputData.LegalNatureCodeCódigo de natureza legal
AdditionalOutputData.LegalNatureNatureza legal
AdditionalOutputData.StatusDateData da situação cadastral
AdditionalOutputData.QueryTimeHorário da consulta
AdditionalOutputData.TerminationDateData de fechamento da empresa
AdditionalOutputData.SpecialSituationSituação especial
AdditionalOutputData.SpecialSituationDateData da situação especial
AdditionalOutputData.StatusReasonMotivo da situação cadastral
AdditionalOutputData.SecondaryActivity.[n]Atividade segundária da empresa
AdditionalOutputData.Phone.[n]Telefone da empresa
AdditionalOutputData.Address.Core.[n]Logradouro da empresa
AdditionalOutputData.Address.City.[n]Cidade da empresa
AdditionalOutputData.Address.Complement.[n]Complemento do endereço da empresa
AdditionalOutputData.Address.Neighborhood.[n]Bairro da empresa
AdditionalOutputData.Address.Number.[n]Número de porta da empresa
AdditionalOutputData.Address.State.[n]Estado da empresa
AdditionalOutputData.Address.ZipCode.[n]CEP da empresa
AdditionalOutputData.Email.[n]Email da empresa
Language
Authorization
Click Try It! to start a request and see the response here!