Hath DataHathData
API de consultaEm produção

QSA: quem responde pela empresa

Envie o CNPJ e receba da Receita Federal o Comprovante do Quadro de Sócios e Administradores: cada sócio com nome e qualificação, o representante legal e o total de sócios.

Emitir o QSA em lote Ver todas as consultas

Acesso no mesmo dia, com crédito para testar · atualizado em 28 de outubro de 2026

  1. 1

    Entrada

    cnpj
  2. 2

    Fonte oficial

    Receita FederalConsulta pública de CNPJ, Quadro de Sócios e Administradores

  3. 3

    Saída

    JSON + PDF

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Empresa fictícia.

Parâmetros

  • cnpjobrigatório

    A empresa.

Campos retornados

com_apontamentos
true quando a consulta encontrou algo que pede atenção (débito, processo, sanção).
certidao_emitida
Se o órgão emitiu o documento nesta consulta.
mensagem_orgao
A mensagem que o próprio portal devolveu, quando há.
documentos
Os documentos emitidos, um por item.
documentos[].com_apontamento
true quando este documento tem apontamento.
documentos[].dias_de_validade
Prazo de validade do documento, em dias.
documentos[].valida_ate
Data de validade, pronta para agendar a renovação.
documentos[].pdf_url
O documento emitido pelo órgão, guardado pela Hath.
documentos[].texto_completo
O texto integral do documento, extraído do PDF.
documentos[].cnpj
CNPJ formatado.
documentos[].razao_social
Nome empresarial.
documentos[].situacao_cadastral
Situação cadastral em maiúsculas.
documentos[].socios
Quadro de sócios e administradores.
documentos[].socios[].nome
Nome do sócio ou administrador.
documentos[].socios[].qualificacao
Qualificação do sócio.
documentos[].socios[].documento
CPF/CNPJ do sócio, se a Receita informar.
documentos[].socios[].data_entrada
Data de entrada na sociedade, se informada.
documentos[].socios[].representante_legal
Nome do representante legal.
documentos[].total_socios
Quantidade de sócios na lista.
documentos[].data_consulta
Data e hora de emissão da consulta.
Tela da consulta pública de CNPJ da Receita Federal, de onde sai o comprovante do Quadro de Sócios e Administradores, com a verificação anti-robô borrada
RespostaJSON
{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": null,"documentos": [{"com_apontamento": false,"dias_de_validade": 30,"valida_ate": "2026-11-26T14:32:10","pdf_url": "https://…/federal-revenu…81.html","texto_completo": "Consulta Quadro de Sócios e …","cnpj": "11.222.333/0001-81","razao_social": "EXEMPLO COMERCIO DE PECAS LTDA","situacao_cadastral": "ATIVA","socios": [{"nome": "FULANO DE TAL","qualificacao": "49-Sócio-Administrador","documento": "","data_entrada": "","representante_legal": ""}],"total_socios": 2,"data_consulta": "27/10/2026 14:32:10"}]}

Como o resultado chega

A mesma estrutura em qualquer órgão: um status classificado e, quando a fonte emite, o PDF oficial. Só a consulta concluída é cobrada; tentativa sem resultado não entra na conta.

  • Regular

    verde

    Nada consta na fonte.

  • Atenção

    amarelo

    Há registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.

  • Com apontamentos

    vermelho

    Consta débito, sanção ou processo. O documento vem junto.

  • Sem resposta

    cinza

    A fonte não respondeu, o captcha falhou ou ficou fora deste ciclo. Vira reprocessamento, nunca um "nada consta" falso.

A entrega sai em JSON, CSV, XLSX ou XML, por API REST, webhook ou direto no seu ERP. Portal que muda de layout, adiciona captcha ou troca de sistema é conta nossa: você paga pela entrega, não pelo conserto.

Como ler o resultado

O QSA público traz quem está no quadro e em que qualificação (sócio-administrador, administrador, sócio), mais o representante legal quando há. O documento do sócio e a data de entrada costumam não vir na consulta pública, e a resposta deixa esses campos vazios em vez de inventar.

É uma consulta informativa: com_apontamento é sempre falso. Para checar o próprio CNPJ, veja a API do Cartão CNPJ; o passo a passo manual está no guia de quadro societário.

Perguntas frequentes

Traz o CPF dos sócios?

Em geral não; a consulta pública costuma omitir.

Mostra o representante legal?

Sim, quando a Receita informa.

Marca apontamento?

Não. O QSA é informativo.

API Comprovante do Quadro de Sócios e Administradores (QSA) na sua integração

Em produção. Acesso no mesmo dia, com crédito para testar.

Emitir o QSA em lote

A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.