API de consulta CNPJ na Receita Federal
Razão social, situação cadastral, CNAE, endereço e quadro societário de qualquer CNPJ — com opção de dado ao vivo da RFB, não de dump mensal defasado. Via API REST ou direto no painel.
Dado ao vivo da Receita Federal
Com force_fresh=true a consulta é feita na RFB no momento da requisição — não em um dump mensal que pode estar semanas defasado.
Cadastro completo em JSON
Razão social, situação cadastral, CNAE, natureza jurídica, capital social, endereço com código IBGE e quadro societário.
API ou painel, sem captcha
Integre com uma chamada REST ou consulte direto no dashboard. Nada de preencher o site da Receita consulta a consulta.
Como funciona via API
Um GET com o CNPJ e a sua chave de API. Adicione force_fresh=true quando precisar do dado mais recente direto da Receita Federal — esse é o modo ao vivo, que consome 3 créditos por chamada, contra 1 crédito da consulta base.
curl "https://api.fiscalapi.com.br/api/consultar-cnpj?cnpj=12345678000199&force_fresh=true" \
-H "x-api-key: SUA_CHAVE_API"Resposta:
{
"request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"cnpj": "12345678000199",
"cached": false,
"source_status": { "status": "success" },
"result": {
"razao_social": "AGROPECUARIA BOA VISTA LTDA",
"nome_fantasia": "FAZENDA BOA VISTA",
"situacao_cadastral": "ATIVA",
"data_situacao_cadastral": "2010-05-20",
"cnae_principal_codigo": "0151-2/01",
"cnae_principal_descricao": "CRIACAO DE BOVINOS PARA CORTE",
"cnaes_secundarios": [
{ "codigo": "0111-3/01", "descricao": "CULTIVO DE ARROZ" }
],
"natureza_juridica": "206-2 - Sociedade Empresaria Limitada",
"capital_social": "500000.00",
"endereco": {
"logradouro": "ROD BR-364 KM 28",
"numero": "S/N",
"bairro": "ZONA RURAL",
"municipio": "CUIABA",
"codigo_ibge": "5103403",
"uf": "MT",
"cep": "78000-000"
},
"qsa": [
{ "nome": "JOAO DA SILVA", "qualificacao": "Socio-Administrador" }
],
"porte": "PEQUENO PORTE"
}
}Campos retornados
| Campo | Conteúdo |
|---|---|
razao_social | Razão social registrada na Receita Federal |
nome_fantasia | Nome fantasia, quando informado |
situacao_cadastral | ATIVA, BAIXADA, SUSPENSA, INAPTA ou NULA |
data_situacao_cadastral | Data da última mudança de situação |
cnae_principal_codigo | Código do CNAE principal |
cnae_principal_descricao | Descrição da atividade principal |
cnaes_secundarios | Lista de CNAEs secundários (código e descrição) |
natureza_juridica | Código e descrição da natureza jurídica |
capital_social | Capital social declarado |
endereco | Logradouro, número, bairro, município, UF, CEP e código IBGE |
qsa | Quadro societário: nome e qualificação de cada sócio |
porte | ME, EPP ou demais portes |
Dado ao vivo x dump mensal gratuito
A maioria das consultas gratuitas de CNPJ na internet serve uma cópia dos dados abertos da Receita Federal, atualizada cerca de uma vez por mês. Para validar um fornecedor ou liberar um crédito, isso significa decidir com base em um retrato que pode estar semanas atrasado — uma empresa baixada ou suspensa ontem ainda aparece como ATIVA.
Na FiscalAPI, o parâmetro force_fresh=true consulta a Receita Federal no momento da requisição e retorna a situação cadastral atual. Use o modo padrão (com cache) para enriquecimento em volume e o modo ao vivo quando a decisão depender do dado do dia.
Quanto custa cada modo. A consulta base — o cadastro completo, servido do cache — consome 1 crédito, como qualquer outra consulta do seu plano. O modo ao vivo consome 3 créditos por chamada e exige plano ativo ou créditos disponíveis: cada requisição resolve um captcha no portal da Receita, e o preço reflete esse custo.
Perguntas frequentes
Quais dados a consulta de CNPJ retorna?
Razão social, nome fantasia, situação cadastral (com data), CNAE principal e secundários (código e descrição), natureza jurídica, capital social, porte, endereço completo (com código IBGE do município) e quadro societário (QSA) com nome e qualificação dos sócios.
Qual a diferença entre dado ao vivo e dump mensal?
A maioria das consultas gratuitas de CNPJ serve uma cópia dos dados abertos da Receita Federal, atualizada uma vez por mês — uma baixa de empresa ou troca de sócio pode levar semanas para aparecer. Na FiscalAPI, o parâmetro force_fresh=true consulta a Receita Federal no momento da requisição e retorna a situação cadastral atual.
Como consultar CNPJ via API?
Envie um GET para /api/consultar-cnpj com o parâmetro cnpj e a sua chave de API no header x-api-key. A resposta vem em JSON com todos os campos cadastrais. Também dá para consultar pelo painel, sem escrever código.
Dá para descobrir a Inscrição Estadual a partir do CNPJ?
Sim. Além dos dados da Receita Federal, a FiscalAPI consulta a Inscrição Estadual vinculada ao CNPJ (ou CPF) nos 27 estados em uma única chamada — útil para validar cadastro de fornecedores e emissão de NF-e.
Quanto custa a consulta ao vivo na Receita?
A consulta base de CNPJ consome 1 crédito, como qualquer outra consulta do seu plano. Já a consulta ao vivo na Receita Federal (force_fresh=true) consome 3 créditos por chamada e exige plano ativo ou créditos disponíveis: cada chamada resolve um captcha no portal da Receita, e o preço reflete esse custo. Para enriquecimento em volume, use o modo padrão e reserve o modo ao vivo para as decisões que dependem do dado do dia.
A consulta de CNPJ é cobrada quando dá erro?
Não. Se a consulta falhar por instabilidade ou erro da infraestrutura, a requisição não é contabilizada no plano. Você só paga por consultas processadas com sucesso.
Consulte qualquer CNPJ, agora.
Cadastro completo da Receita Federal, com opção de dado ao vivo. Pelo painel ou via API REST.