API de consulta CNPJ: dados da Receita Federal em JSON

Consulta dados cadastrais de um CNPJ na Receita Federal (razão social, CNAE, QSA, endereço e mais).

GET /api/consultar-cnpj

Consulta os dados cadastrais de uma empresa na Receita Federal pelo CNPJ. Retorna informações completas incluindo razão social, situação cadastral, CNAE principal e secundários, quadro societário (QSA), capital social e endereço.

Autenticação

Envie sua chave no header X-API-Key. Veja Autenticação para detalhes.

Parâmetros de consulta

Name	Type	Required	Description
`cnpj`	string	Sim	CNPJ do contribuinte (somente números, 14 dígitos).
`force_fresh`	boolean	Não	Quando `true`, consulta os dados AO VIVO na Receita Federal (dados atuais), em vez da base pública mensal. Custa 3 créditos (padrão: `false`, 1 crédito).

Frescor dos dados: base mensal vs ao vivo

Por padrão a consulta usa a base pública mensal da Receita Federal — rápida e barata (1 crédito), mas pode estar defasada em até ~1 mês (ex.: uma empresa que mudou de natureza jurídica recentemente ainda pode aparecer com os dados antigos).

Para o dado atual, use force_fresh=true: a consulta vai ao vivo ao serviço da Receita no momento da chamada e retorna o cadastro atualizado.

Consulta ao vivo (force_fresh=true) custa 3 créditos (vs 1 da consulta normal), pode levar alguns segundos a mais e reflete o dado atual da Receita. Consultas repetidas do mesmo CNPJ em um curto intervalo são servidas de cache (sem custo adicional de processamento).

Exemplos de código

curl -X GET "https://api.fiscalapi.com.br/api/consultar-cnpj?cnpj=12345678000199" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-cnpj?cnpj=12345678000199",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
console.log(data.result);

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-cnpj",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cnpj": "12345678000199"},
)
data = response.json()
print(data["result"])

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/consultar-cnpj', [
    'cnpj' => '12345678000199',
]);
$data = $response->json();

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "fapi_sua_chave_aqui");
var response = await client.GetAsync(
    "https://api.fiscalapi.com.br/api/consultar-cnpj?cnpj=12345678000199"
);
var data = await response.Content.ReadAsStringAsync();

Resposta

Campos de nível superior

Campo	Tipo	Descrição
`request_id`	string	Identificador único da requisição (UUID).
`cnpj`	string	CNPJ consultado.
`cached`	boolean	Indica se o resultado veio do cache.
`source_status`	object	Status da consulta na Receita Federal.
`source_status.status`	string	`success` ou `error`.
`source_status.error_code`	string	Código de erro (vazio se sucesso).
`source_status.error_message`	string	Mensagem de erro (vazio se sucesso).
`result`	object	Dados cadastrais do CNPJ.

Campos do resultado (`result`)

Campo	Tipo	Descrição
`razao_social`	string	Razão social da empresa.
`nome_fantasia`	string	Nome fantasia.
`situacao_cadastral`	string	Situação cadastral: `ATIVA`, `BAIXADA`, `SUSPENSA`, etc.
`data_situacao_cadastral`	string	Data da situação cadastral (formato `YYYY-MM-DD`).
`cnae_principal_codigo`	string	Código CNAE da atividade principal.
`cnae_principal_descricao`	string	Descrição da atividade principal.
`cnaes_secundarios`	array	Lista de CNAEs secundários.
`cnaes_secundarios[].codigo`	string	Código do CNAE secundário.
`cnaes_secundarios[].descricao`	string	Descrição do CNAE secundário.
`natureza_juridica`	string	Natureza jurídica da empresa.
`capital_social`	string	Capital social (valor decimal como string).
`endereco`	object	Endereço da empresa.
`endereco.logradouro`	string	Logradouro.
`endereco.numero`	string	Número.
`endereco.complemento`	string	Complemento do endereço (ex: `GALPAO 2`).
`endereco.bairro`	string	Bairro.
`endereco.municipio`	string	Município.
`endereco.uf`	string	UF.
`endereco.cep`	string	CEP.
`endereco.codigo_ibge`	string	Código IBGE do município (7 dígitos).
`qsa`	array	Quadro de Sócios e Administradores.
`qsa[].nome`	string	Nome do sócio.
`qsa[].qualificacao`	string	Qualificação do sócio.
`porte`	string	Porte da empresa (ex: `PEQUENO PORTE`, `DEMAIS`).

Exemplo de resposta

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "cnpj": "12345678000199",
  "cached": false,
  "source_status": {
    "status": "success",
    "error_code": "",
    "error_message": ""
  },
  "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",
      "complemento": "GALPAO 2",
      "bairro": "ZONA RURAL",
      "municipio": "CUIABA",
      "uf": "MT",
      "cep": "78000-000",
      "codigo_ibge": "5103403"
    },
    "qsa": [
      {
        "nome": "JOAO DA SILVA",
        "qualificacao": "Socio-Administrador"
      }
    ],
    "porte": "PEQUENO PORTE"
  }
}

Códigos de erro

Código	HTTP Status	Descrição
`PARAMETRO_AUSENTE`	400	O parâmetro `cnpj` não foi informado.
`DOCUMENTO_INVALIDO`	400	O CNPJ informado não é válido.
`CNPJ_NAO_ENCONTRADO`	404	Nenhum registro encontrado para o CNPJ informado.
`SITE_INDISPONIVEL`	503	O serviço da Receita Federal está indisponível no momento.
`RF_LIVE_ERROR`	502	Falha temporária na consulta ao vivo (`force_fresh=true`). Tente novamente.
`LIMITE_ATINGIDO`	402	Saldo de créditos insuficiente (a consulta ao vivo custa 3 créditos).
`ERRO_INTERNO`	500	Erro interno no servidor.

Esta pagina foi util?

Consultar CNPJ