CNPJ na Receita Federal
Nossa API permite consultar dados cadastrais completos de empresas quase que diretamente no banco de dados da Receita Federal. Nosso atraso é de no máximo 25 dias. Obtenha informações como razão social, endereço, atividade econômica (CNAE), situação cadastral e mais, com atualização em tempo real.
Informações de entrada
Para consultar um CNPJ, utilize os seguintes parâmetros
CNPJ: O número do Cadastro Nacional da Pessoa Jurídica (CNPJ) da empresa que deseja consultar.
Cache: Define se os dados podem ser retornados a partir de um cache recente ou se uma nova consulta deve ser realizada diretamente nas fontes oficiais. O valor aceito vai de 0 a 45, sendo que qualquer número acima de 0 indica que o cache deve ser utilizado, se disponível, enquanto o valor 0 força uma nova consulta, ignorando completamente o cache. O cache é compartilhado entre os clientes, o que significa que uma consulta realizada por um cliente pode alimentar o cache utilizado por outros.
Parâmetros Obrigatórios
- Name
cnpj
- Type
- string
- Description
Documento fiscal da empresa - pode ser informado em qualquer padrão de formatação contanto que esteja completo.
Exemplo:
12345678000195
Códigos de Erro Comuns
Código HTTP | Código Interno | Descrição | Solução Recomendada |
---|---|---|---|
400 | CNPJ_INVALIDO | CNPJ mal formatado, incompleto ou dígitos verificadores incorretos. | Verifique se o CNPJ possui 14 dígitos e está formatado corretamente (com ou sem pontuação). |
401 | API_KEY_INVALIDA | Chave de API ausente, expirada ou inválida. | Verifique sua chave de API no painel ou entre em contato com o suporte. |
404 | CNPJ_NAO_ENCONTRADO | CNPJ não existe ou foi excluído da base da Receita Federal. | Confira o número digitado ou consulte manualmente no site oficial. |
429 | LIMITE_EXCEDIDO | Limite de requisições por minuto/dia atingido. | Reduza a frequência de consultas ou atualize para um plano com maior limite. |
500 | ERRO_INTERNO | Falha temporária no servidor ou na conexão com a Receita Federal. | Tente novamente após alguns minutos. Persistindo, reporte ao suporte. |
503 | SERVICO_INDISPONIVEL | Serviço da Receita Federal fora do ar ou em manutenção. | Aguarde e tente mais tarde. Consulte o status oficial. |
Receita Federal PJ
Esse endpoint habilita você receber os dados do CNPJ mais atualizados, consultados diretamente na Receita Federal do Brasil (RFB).
Atributos opcionais
- Name
cache
- Type
- number
- Description
Informa a API se ela pode consultar o cache ou não. Nós recomendamos sempre configurar um cache de até 10 dias (é o default). Utilizar o cache faz com que haja um ganho de performance já que a API não precisará quebrar o captcha do portal, porém, a informação pode ter uma atraso de até 25 dias, que é o tempo que as bases do governo são atualizadas.
Requisição
curl -G https://api.sintegrapi.com.br/consultas/cnpj-receita-federal/{cnpj} \
-H "x-api-key: {apiKey}" \
-H "cache: 10"
Resposta
{
"request_id": "326dd48e-4039-4e27-b339-33ad3bedbefa",
"success": true,
"error": false,
"error_message": null,
"response": {
"cnpj": "15436940000103",
"identificador_matriz_filial": "Matriz",
"data_de_abertura": "2012-04-02",
"nome_empresarial": "AMAZON SERVICOS DE VAREJO DO BRASIL LTDA.",
"nome_fantasia": "AMAZON.COM.BR",
"atividade_economica_principal": {
"codigo": "4761001",
"descricao": "Comercio varejista de livros"
},
"atividades_economicas_secundarias": [
{
"codigo": "4530703",
"descricao": "Comercio a varejo de pecas e acessorios novos para veiculos automotores"
},
{
"codigo": "4530705",
"descricao": "Comercio a varejo de pneumaticos e camaras-de-ar"
},
{
"codigo": "4541206",
"descricao": "Comercio a varejo de pecas e acessorios novos para motocicletas e motonetas"
},
],
"natureza_juridica": {
"codigo": "Sociedade Empresaria Limitada",
"descricao": "DEMAIS"
},
"logradouro": "PRES JUSCELINO KUBITSCHEK",
"numero": "2041",
"complemento": "ANDAR 18 20 21 22 E 23",
"cep": "04543011",
"municipio": "SAO PAULO",
"uf": "SP",
"endereco_eletronico": "[email protected]",
"telefone": "1141302000",
"ente_federativo_responsavel": "",
"situacao_cadastral": "SEM MOTIVO",
"data_da_situacao_cadastral": "2012-04-02",
"situacao_especial": "",
"data_da_situacao_especial": "",
"socios": [
{
"nome": "RICARDO JOSE THOMAZ PAGANI",
"cpf_cnpj_socio": "***678298**",
...
},
{
"nome": "RAINFOREST HOLDCO 1 LLC",
"cpf_cnpj_socio": "28886481000101",
"qualificacao_socio": "Socio Pessoa Juridica Domiciliado no Exterior",
"data_entrada_sociedade": "2017-11-30",
"pais": "ESTADOS UNIDOS",
"documento_representante_legal": "***747448**",
"nome_representante_legal": "FERNANDO GENTIL MONTEIRO",
"faixa_etaria": "0"
},
]
}
}