Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.
Consulta cadastral de CNPJ executada ao vivo na Receita Federal a cada chamada, sem nenhuma camada de cache. É o irmão PJ da consulta ao vivo de CPF, e existe para um caso específico: quando o dado precisa refletir o estado de agora, não o de uma cópia atualizada periodicamente.
Escolha entre esta consulta e a cadastral padrão de CNPJ:
Cadastral de CNPJ (padrão)
Esta consulta (ao vivo)
Origem
Base cadastral da Receita Federal
Consulta direta à Receita Federal
Atualização
Ciclo mensal — o dado pode ter semanas
No momento da chamada
Tempo de resposta
Sub-segundo
Alguns segundos
Preço
Menor
Maior
Carimbo de frescor
—
consultado_em
Se o seu caso tolera dado com semanas de idade (enriquecimento em lote, validação de cadastro, preenchimento de formulário), a consulta padrão entrega o mesmo conteúdo mais rápido e mais barato. Use esta aqui em decisão sensível ao instante: liberação de crédito, onboarding sob análise, reverificação de contraparte cuja situação cadastral pode ter mudado.
O teto do dado, declarado antes que você descubra sozinho:
O QSA vem sem documento. A divulgação pública do quadro societário traz apenas o nome e a qualificação de cada sócio — não o CPF, nem mesmo mascarado. Para obter o documento completo de cada sócio e caminhar a cadeia societária, use a consulta de vínculos societários (UBO), que é um produto distinto.
Não há percentual de participação. Nenhuma fonte pública informa quanto cada sócio detém.
Sociedade Anônima não expõe acionistas. O registro cadastral de uma S.A. lista apenas diretoria e administradores. Cadeia societária completa só é rastreável em sociedades limitadas (Ltda).
Esta consulta não emite comprovante. Ela devolve dados, com o carimbo de quando foram lidos — não um documento com código de controle verificável em portal oficial. Se o seu processo exige um comprovante auditável, esta consulta não o substitui.
CNPJ da empresa a consultar. Aceita com ou sem máscara (00000000000000 ou 00.000.000/0000-00).
00.000.000/0000-00
Resposta
Frescor
Campo
Descrição
consultado_em
Data e hora em que a fonte oficial foi consultada, em ISO 8601 com horário (yyyy-MM-ddTHH:mm:ss), fuso de Brasília. Como não há cache, este carimbo é a idade do dado: ele é sempre o instante da sua chamada. É o campo que distingue esta consulta da cadastral padrão — registre-o se precisar provar quando o dado foi obtido.
Identificação e situação
Campo
Descrição
cnpj
CNPJ consultado, somente dígitos.
razao_social
Razão social registrada.
nome_fantasia
Nome fantasia, quando declarado (null quando não há).
matriz_filial
MATRIZ ou FILIAL.
data_abertura
Início de atividade, em ISO 8601 (yyyy-MM-dd).
situacao_cadastral
Situação atual em texto: ATIVA, BAIXADA, SUSPENSA, INAPTA ou NULA. É o campo de decisão da maioria das integrações.
data_situacao_cadastral
Desde quando a situação atual vale (yyyy-MM-dd). Numa baixa ou inaptidão, é a data do evento.
observacoes_situacao_cadastral
Observação da Receita Federal sobre a situação, quando houver. Normalmente null.
situacao_especial / data_situacao_especial
Situação especial (ex.: liquidação, intervenção) e sua data. null quando não há — que é o caso da grande maioria das empresas.
Enquadramento e atividade
Campo
Descrição
natureza_juridica
Descrição da natureza jurídica, já sem o código (ex.: Sociedade Empresária Limitada).
codigo_natureza_juridica
Código correspondente na tabela oficial (ex.: 2062).
porte
Porte declarado (ME, EPP, DEMAIS). Declarado pelo contribuinte, não apurado.
capital_social
Capital social em reais, como número — não string formatada.
cnae_principal_codigo / cnae_principal_descricao
Atividade econômica principal, já separada em código e descrição, para você não ter que fatiar string.
cnaes_secundarios
Lista de atividades secundárias, cada item no formato "<código> - <descrição>". Lista vazia quando a empresa não declara nenhuma.
Endereço e contato
Campo
Descrição
logradouro / numero / complemento / bairro / municipio / uf / cep
Endereço cadastral. cep vem somente com dígitos. complemento pode vir null quando a Receita Federal não divulga o campo.
telefone / email
Contato cadastrado. Frequentemente null: são campos que dependem de atualização voluntária do contribuinte.
ente_federativo_responsavel
Preenchido apenas para órgãos e entidades públicas; null para empresas privadas.
Quadro de Sócios e Administradores (qsa)
Campo
Descrição
nome
Nome do sócio ou administrador (pessoa física) ou razão social (pessoa jurídica).
qualificacao
Papel no quadro, com o código oficial (ex.: 49-Sócio-Administrador, 10-Diretor, 22-Sócio).
Representante legal do sócio, quando o sócio exige representação. null no caso comum.
pais_origem
País de origem do sócio domiciliado no exterior. null para sócios brasileiros.
O qsa vem como lista vazia quando a natureza jurídica não publica quadro societário (empresário individual, MEI) — lista vazia é resposta válida, não erro.
{
"type": "object",
"properties": {
"uf": {
"type": [
"string",
"null"
],
"description": "Unidade federativa (sigla)."
},
"cep": {
"type": [
"string",
"null"
],
"description": "CEP, somente dígitos (8 posições)."
},
"qsa": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"nome": {
"type": [
"string",
"null"
],
"description": "Nome do sócio ou administrador (pessoa física) ou razão social (pessoa jurídica)."
},
"pais_origem": {
"type": [
"string",
"null"
],
"description": "País de origem do sócio, quando domiciliado no exterior."
},
"qualificacao": {
"type": [
"string",
"null"
],
"description": "Qualificação no quadro, com o código da Receita Federal (ex.: 49-Sócio-Administrador)."
},
"nome_representante_legal": {
"type": [
"string",
"null"
],
"description": "Nome do representante legal do sócio, quando o sócio exige representação."
},
"qualificacao_representante_legal": {
"type": [
"string",
"null"
],
"description": "Qualificação do representante legal, quando houver."
}
}
},
"description": "Quadro de Sócios e Administradores. SEM documento (CPF/CNPJ) — a divulgação pública do QSA traz apenas o nome. Lista vazia quando a natureza jurídica não publica quadro societário."
},
"cnpj": {
"type": [
"string",
"null"
],
"description": "CNPJ consultado, somente dígitos (14 posições)."
},
"email": {
"type": [
"string",
"null"
],
"description": "E-mail cadastrado. Frequentemente ausente na base pública."
},
"porte": {
"type": [
"string",
"null"
],
"description": "Porte declarado (ex.: ME, EPP, DEMAIS)."
},
"bairro": {
"type": [
"string",
"null"
],
"description": "Bairro ou distrito."
},
"numero": {
"type": [
"string",
"null"
],
"description": "Número do imóvel."
},
"telefone": {
"type": [
"string",
"null"
],
"description": "Telefone cadastrado, com DDD. Frequentemente ausente na base pública."
},
"municipio": {
"type": [
"string",
"null"
],
"description": "Município."
},
"logradouro": {
"type": [
"string",
"null"
],
"description": "Logradouro do endereço cadastral, incluindo o tipo (ex.: AV REPUBLICA DO CHILE)."
},
"complemento": {
"type": [
"string",
"null"
],
"description": "Complemento do endereço. null quando a Receita Federal não divulga o campo."
},
"razao_social": {
"type": [
"string",
"null"
],
"description": "Razão social (nome empresarial) registrado na Receita Federal."
},
"consultado_em": {
"type": [
"string",
"null"
],
"description": "Data e hora em que esta consulta foi executada na fonte oficial, em ISO 8601 com horário (yyyy-MM-ddTHH:mm:ss), fuso de Brasília. Como este endpoint não usa cache, este carimbo é também a idade do dado."
},
"data_abertura": {
"type": [
"string",
"null"
],
"description": "Data de abertura / início de atividade, em ISO 8601 (yyyy-MM-dd)."
},
"matriz_filial": {
"type": [
"string",
"null"
],
"description": "MATRIZ ou FILIAL."
},
"nome_fantasia": {
"type": [
"string",
"null"
],
"description": "Nome fantasia (título do estabelecimento), quando declarado."
},
"capital_social": {
"type": [
"number",
"null"
],
"description": "Capital social declarado, em reais, como número (não string formatada)."
},
"cnaes_secundarios": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"description": "Atividade secundária no formato \"<código> - <descrição>\"."
},
"description": "Atividades econômicas secundárias. Lista vazia quando a empresa não declara nenhuma."
},
"natureza_juridica": {
"type": [
"string",
"null"
],
"description": "Descrição da natureza jurídica, já sem o código (ex.: Sociedade Empresária Limitada)."
},
"situacao_especial": {
"type": [
"string",
"null"
],
"description": "Situação especial (ex.: liquidação, intervenção), quando houver. null quando não há."
},
"situacao_cadastral": {
"type": [
"string",
"null"
],
"description": "Situação cadastral atual, em texto (ATIVA, BAIXADA, SUSPENSA, INAPTA, NULA)."
},
"cnae_principal_codigo": {
"type": [
"string",
"null"
],
"description": "Código CNAE da atividade econômica principal, formatado (ex.: 06.00-0-01)."
},
"data_situacao_especial": {
"type": [
"string",
"null"
],
"description": "Data da situação especial, em ISO 8601 (yyyy-MM-dd). null quando não há situação especial."
},
"data_situacao_cadastral": {
"type": [
"string",
"null"
],
"description": "Data em que a situação cadastral atual passou a valer, em ISO 8601 (yyyy-MM-dd)."
},
"cnae_principal_descricao": {
"type": [
"string",
"null"
],
"description": "Descrição da atividade econômica principal."
},
"codigo_natureza_juridica": {
"type": [
"string",
"null"
],
"description": "Código da natureza jurídica na tabela da Receita Federal (ex.: 2062)."
},
"ente_federativo_responsavel": {
"type": [
"string",
"null"
],
"description": "Ente federativo responsável — preenchido apenas para órgãos e entidades públicas."
},
"observacoes_situacao_cadastral": {
"type": [
"string",
"null"
],
"description": "Observação da Receita Federal sobre a situação cadastral. Normalmente ausente (null)."
}
}
}
Códigos de erro
Código
Mensagem
Quando acontece
400
Parâmetros inválidos para esta consulta.
CNPJ ausente, com dígito verificador inválido ou fora do formato. Máscara é aceita (00.000.000/0000-00). Não é cobrada.
401
Chave de API ausente ou inválida.
Header X-API-Key não enviado ou não reconhecido.
403
Saldo insuficiente ou acesso negado a este endpoint.
Conta sem saldo para cobrir a consulta ou sem permissão no catálogo da marca.
404
Nenhum registro localizado para o CNPJ consultado.
O CNPJ tem dígito verificador válido mas não existe no Cadastro Nacional da Pessoa Jurídica. Resultado AUTORITATIVO (a fonte oficial afirmou a inexistência) e, por isso, COBRADO — a consulta ao vivo foi executada e faturada na origem.
408
A consulta excedeu o tempo limite. Tente novamente.
A fonte oficial não respondeu dentro do orçamento de tempo da consulta. Não é cobrada.
503
A fonte oficial está indisponível no momento. Tente novamente em alguns minutos.
Indisponibilidade ou instabilidade do sistema da Receita Federal. Não é cobrada — quando a origem não nos cobra, não cobramos você.
Quando usar
Decisão sensível ao instante — liberação de crédito, limite, contratação: confirmar que a empresa está ATIVAagora, e não segundo uma cópia de semanas atrás. Uma baixa ou inaptidão recente é exatamente o que uma réplica periódica ainda não reflete.
Reverificação de contraparte já cadastrada — monitorar mudança de situação cadastral, endereço ou quadro societário de clientes e fornecedores ativos, com consultado_em registrando a data de cada verificação para trilha de auditoria.
Onboarding de PJ sob análise (KYB) — dados cadastrais no momento da análise, combinados com a consulta de vínculos societários quando for preciso identificar beneficiário final com documento completo.
Conferência pontual sobre divergência — quando o dado da consulta cadastral padrão foi contestado ou parece desatualizado, esta consulta resolve a dúvida indo à fonte.
Para volume, enriquecimento em lote ou qualquer caso que tolere dado com semanas de idade, prefira a consulta cadastral de CNPJ padrão: mesmo conteúdo, resposta sub-segundo e custo menor. Para a cadeia societária com documento completo dos sócios, use a consulta de vínculos societários (UBO).
Integrar
OpenAPI (JSON) ↗ — importe a URL
no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar
pelo chat: conecte via MCP. Esta página em Markdown.