API Receita Federal CNPJ

Documentação da API Receita Federal CNPJ

Recuperar dados de uma empresa na Receita Federal

Método para recuperar as informações de uma empresa brasileira através do seu CNPJ. As informações são exatamente as mesmas retornadas pelo site da Receita Federal.

GET

URL para requisição 

https://www.sintegraws.com.br/api/v1/execute-api.php?token={token}&cnpj={cnpj}&plugin={RF}

Parâmetros de requisição da API do Receita Federal

token
string

obrigatório
O seu token é gerado após o cadastro no portal.
Ver meu token

cnpj
string

obrigatório
CNPJ que deseja obter as informações da Receita Federal. Utilize o formato 00000000000000.

plugin
string

obrigatório
Site no qual deseja as informações, no caso da API Receita Federal CNPJ informar "RF".

Exemplo de resposta da API Receita Federal
Uma resposta típica é composta por um JSON.

  • Status: 200 OK
  • Time: 200 ms
  • Size: 2021 bytes 
{"code":"0","status":"OK","message":"Pesquisa realizada com sucesso.","cnpj":"06.990.590\/0001-23","nome":"GOOGLE BRASIL INTERNET LTDA.","fantasia":"********","cep":"04.538-133","uf":"SP","municipio":"S\u00e3o Paulo","bairro":"ITAIM BIBI","tipo_logradouro":"AVENIDA","logradouro":"AV BRIG FARIA LIMA","numero":"3477","complemento":"ANDAR 17A20 TSUL 2 17A20","telefone":"(11) 2395-8400","email":"GOOGLEBRASIL@GOOGLE.COM","capital_social":"200.000.000,00","capital_socialvalor_extenso":"Duzentos milh\u00f5es de reais","data_situacao":"01\/09\/2004","data_situacao_especial":"********","abertura":"01\/09\/2004","motivo_situacao":null,"sigla_natureza_juridica":"n\u00e3o informado","natureza_juridica":"206-2 - Sociedade Empres\u00e1ria Limitada","situacao":"ATIVA","situacao_especial":"********","tipo":"MATRIZ","atividade_principal":[{"code":"6319400","text":"Portais, provedores de conte\u00fado e outros servi\u00e7os de informa\u00e7\u00e3o na internet"}],"atividades_secundarias":[{"code":"4751201","text":"Com\u00e9rcio varejista especializado de equipamentos e suprimentos de inform\u00e1tica"},{"code":"6201501","text":"Desenvolvimento de programas de computador sob encomenda"},{"code":"6202300","text":"Desenvolvimento e licenciamento de programas de computador customiz\u00e1veis"},{"code":"6311900","text":"Tratamento de dados, provedores de servi\u00e7os de aplica\u00e7\u00e3o e servi\u00e7os de hospedagem na internet"},{"code":"6462000","text":"Holdings de institui\u00e7\u00f5es n\u00e3o-financeiras"},{"code":"7319004","text":"Consultoria em publicidade"},{"code":"8299799","text":"Outras atividades de servi\u00e7os prestados principalmente \u00e0s empresas n\u00e3o especificadas anteriormente"}],"qsa":[{"qual":"37-S\u00f3cio Pessoa Jur\u00eddica Domiciliado no Exterior","qual_rep_legal":"17-Procurador","nome_rep_legal":"Yun Ki Lee","cpf_rep_legal":"***.746.608-**","pais_origem":"Estados Unidos","nome":"GOOGLE LLC","faixa_etaria":"N\u00e3o se aplica","tax_id":"06.947.284\/0001-04","tipo_socio":"Pessoa Ju\u00eddica","cod_tipo_socio":"1","img_profile":"","data_entrada":"01\/09\/2004"},{"qual":"37-S\u00f3cio Pessoa Jur\u00eddica Domiciliado no Exterior","qual_rep_legal":"17-Procurador","nome_rep_legal":"Yun Ki Lee","cpf_rep_legal":"***.746.608-**","pais_origem":"Estados Unidos","nome":"GOOGLE INTERNATIONAL LLC","faixa_etaria":"N\u00e3o se aplica","tax_id":"06.947.283\/0001-60","tipo_socio":"Pessoa Ju\u00eddica","cod_tipo_socio":"1","img_profile":"","data_entrada":"01\/09\/2004"},{"qual":"05-Administrador","qual_rep_legal":"","nome_rep_legal":null,"cpf_rep_legal":"***.133.807-**","pais_origem":"Brasil","nome":"Fabio Jose Silva Coelho","faixa_etaria":"61 a 70 anos","tax_id":"***.133.807-**","tipo_socio":"Pessoa F\u00edsica","cod_tipo_socio":"2","img_profile":"","data_entrada":"26\/08\/2014"}],"ultima_atualizacao":"15\/06\/2026 19:04:30","efr":"*****","porte":"DEMAIS","ibge":{"codigo_municipio":"3550308","codigo_uf":"35","ibge_municipio":"S\u00e3o Paulo"},"cnpjs_do_grupo":[{"cnpj":"06990590000395","uf":"MG","tipo":"FILIAL"},{"cnpj":"06990590000808","uf":"RJ","tipo":"FILIAL"},{"cnpj":"06990590000204","uf":"SP","tipo":"FILIAL"},{"cnpj":"06990590000980","uf":"SP","tipo":"FILIAL"},{"cnpj":"06990590000638","uf":"SP","tipo":"FILIAL"},{"cnpj":"06990590001014","uf":"SP","tipo":"FILIAL"},{"cnpj":"06990590000123","uf":"SP","tipo":"MATRIZ"},{"cnpj":"06990590000719","uf":"SP","tipo":"FILIAL"},{"cnpj":"06990590000476","uf":"SP","tipo":"FILIAL"},{"cnpj":"06990590000557","uf":"SP","tipo":"FILIAL"}],"inscricao_municipal":"33555800","coordinates":{"latitude":"-23.5876192","longitude":"-46.6819275"}}

Campos de retorno da API Receita Federal

code string
Código de retorno utilizado para informar o status da requisição.
status string
Indica a situação da requisição.
Valores possíveis:
  • OK
  • ERROR
message string
Mensagem explicativa indicando o campo status.
cnpj string
CNPJ no formato 00.000.000/0000-00.
tipo string
Tipo do CNPJ cadastrado na Receita Federal.
Valores possíveis:
  • MATRIZ
  • FILIAL
porte string
Porte do CNPJ na Receita Federal.
Valores possíveis:
  • ME Micro empresa.
  • EPP Empresa de pequeno porte.
  • DEMAIS
situacao string
Situação cadastral do CNPJ na Receita Federal.
Valores possíveis:
  • NULA
  • ATIVA
  • SUSPENSA
  • INAPTA
  • BAIXADA
abertura string
Data de abertura no formato dd/mm/aaaa.
nome string
Razão social.
fantasia string
Nome fantasia.
tipo_logradouro string Novidade
Tipo do logradouro.
logradouro string
Logradouro.
numero string
Número.
complemento string
Complemento.
cep string
CEP no formato 00.000-000.
bairro string
Bairro.
municipio string
Município.
uf string
Sigla da Unidade da Federação.
email string
Email.
telefone string
Telefone.
efr string
Entidade Federativa Responsável, disponibilizado apenas para CNPJs da administração pública.
data_situacao string
Data da situação no formato dd/mm/aaaa.
motivo_situacao string|null
Motivo da situação.
situacao_especial string
Situação especial.
data_situacao_especial string
Data da situação especial no formato dd/mm/aaaa.
capital_social string
Valor do capital social.
capital_socialvalor_extenso string Novidade
Valor do capital social por extenso.
sigla_natureza_juridica string Novidade
Sigla da natureza jurídica.
natureza_juridica string
Natureza jurídica.
ultima_atualizacao string Novidade
Data e hora da última atualização dos dados.
inscricao_municipal string Novidade
Inscrição municipal da empresa.
atividade_principal Array [objeto]
Atividade principal. Um array com um elemento.

atividade_principal.code string
Código CNAE da atividade no formato 0000000.
atividade_principal.text string
Descrição da atividade.
atividades_secundarias Array [objeto]
Atividades secundárias.

atividades_secundarias.code string
Código CNAE da atividade.
atividades_secundarias.text string
Descrição da atividade.
qsa Array [objeto]
Quadro de Sócios e Administradores.

qsa.nome string
Nome do sócio.
qsa.qual string
Qualificação do sócio.
qsa.pais_origem string
País de origem do sócio.
qsa.nome_rep_legal string|null
Nome do representante legal.
qsa.qual_rep_legal string
Qualificação do representante legal.
qsa.cpf_rep_legal string Novidade
CPF mascarado do representante legal.
qsa.faixa_etaria string Novidade
Faixa etária do sócio.
qsa.tax_id string Novidade
Documento fiscal do sócio.
qsa.tipo_socio string Novidade
Tipo do sócio.
qsa.cod_tipo_socio string Novidade
Código do tipo de sócio.
qsa.img_profile string Novidade
Imagem de perfil do sócio, quando disponível.
qsa.data_entrada string Novidade
Data de entrada do sócio, no formato dd/mm/aaaa.
ibge objeto
Informações de códigos IBGE.

ibge.codigo_municipio string
Código IBGE do município.
ibge.codigo_uf string
Código IBGE da UF.
ibge.ibge_municipio string Novidade
Nome do município conforme IBGE.
cnpjs_do_grupo Array [objeto]
CNPJs do grupo da empresa pesquisada.

cnpjs_do_grupo.cnpj string
CNPJ no formato 00000000000000.
cnpjs_do_grupo.uf string
Sigla da Unidade da Federação.
cnpjs_do_grupo.tipo string
Tipo do CNPJ cadastrado na Receita Federal.
Valores possíveis:
  • MATRIZ
  • FILIAL
coordinates objeto Novidade
Coordenadas geográficas do endereço.

coordinates.latitude string
Latitude.
coordinates.longitude string
Longitude.
Retornos disponíveis
Status Request code status message
200 OK 0 OK Pesquisa realizada com sucesso.
200 OK 1 OK CNPJ não tem cadastro na Receita Federal.
200 OK 2 ERROR CNPJ inválido.
401 Unauthorized 3 ERROR Token inválido.
200 OK 4 ERROR Usuário não contratou nenhum pacote de créditos.
200 OK 5 ERROR Os créditos contratados acabaram.
200 OK 6 ERROR Plugin não existe.
200 OK 7 ERROR Site da Receita Federal está com instabilidade.
200 OK 8 ERROR Ocorreu um erro interno, por favor contatar o nosso suporte.