# O que é o QSA do CNPJ e como consultar o quadro societário por API

> Versão em Markdown de https://datax.plus/guias/qsa-cnpj-quadro-societario-api/

O QSA é a lista de sócios e administradores de uma empresa no cadastro da Receita Federal. Veja o que ele mostra, o que fica de fora, o que significa cada qualificação e como consultar por API.

Por [Equipe DataX](https://datax.plus/) · Publicado em 4 de novembro de 2026 · 6 min de leitura

Resposta curta

QSA é o Quadro de Sócios e Administradores: a lista, no cadastro do CNPJ, das pessoas e empresas que compõem uma sociedade ou a administram. Ele traz o nome, a qualificação e a data de entrada de cada um, mas não o percentual de participação nem o contato pessoal. A consulta no site da Receita é gratuita, uma empresa por vez. Por API, na DataX, o quadro vem em `GET /v1/empresas/{cnpj}`, e o telefone e o e-mail de cada sócio pessoa física, em `POST /v1/empresas/{cnpj}/socios`.

## O que o QSA mostra, e o que não mostra

| Informação | No QSA? | Observação |
| --- | --- | --- |
| Nome do sócio ou administrador | Sim | Pessoa física ou jurídica |
| Qualificação | Sim | Sócio-Administrador, Diretor, Presidente etc. |
| Data de entrada na sociedade | Sim | Nos dados abertos |
| Faixa etária | Sim | Nos dados abertos, em faixas como 41 a 50 anos |
| CPF do sócio | Parcial | Nos dados abertos, só os 6 dígitos do meio ficam visíveis |
| Percentual de participação | Não | O QSA diz quem é sócio, não quanto cada um tem |
| Telefone e e-mail pessoal | Não | O contato do cadastro é o da empresa |

Para saber a participação de cada sócio, a fonte costuma ser o contrato social, registrado na Junta Comercial. Para chegar ao contato de cada um, é preciso cruzar com bases de contato: o [guia de sócios pelo CNPJ](https://datax.plus/guias/telefone-email-socios-cnpj/) mostra como.

## O que significa cada qualificação

A qualificação diz qual é o papel da pessoa na empresa. A Receita usa uma tabela de códigos, e estes são os mais comuns:

| Código | Qualificação | O que indica |
| --- | --- | --- |
| 49 | Sócio-Administrador | É sócio e também responde pela administração |
| 22 | Sócio | Tem participação, mas não administra |
| 05 | Administrador | Administra a empresa, mesmo sem ser sócio |
| 10 | Diretor | Comum em sociedades anônimas |
| 16 | Presidente | Comum em sociedades anônimas e associações |
| 65 | Titular Pessoa Física Residente ou Domiciliado no Brasil | Dono único da empresa |

Em vendas B2B, os sócios-administradores e administradores costumam ser os primeiros a procurar, porque respondem pela empresa. Em grandes empresas, o QSA lista a diretoria, que nem sempre é quem decide a compra do seu produto.

## Formas de consultar

| Forma | Custo | Bom para | Limitação |
| --- | --- | --- | --- |
| Site da Receita Federal | Grátis | Olhar uma empresa de vez em quando | Uma por vez, com captcha |
| Arquivos abertos da Receita | Grátis | Montar a sua própria base com todas as empresas | Arquivos grandes, para baixar e processar todo mês |
| [API gratuita](https://datax.plus/guias/api-cnpj-gratuita-ou-paga/) | Grátis | Sistemas com volume baixo | Limites de uso, sem garantia de disponibilidade |
| [API da DataX](https://datax.plus/api-consulta-cnpj/) | Teste grátis; depois, a partir de R$ 299/mês | Integração com volume e contato dos sócios | Consultas de CNPJ só nos planos Intermediário e Avançado |
| [Portal da DataX](https://datax.plus/#portal) | Teste grátis; depois, a partir de R$ 299/mês | Consultar empresas sem programar, com o contato dos sócios | Manual, e conta nos limites do plano |

## Como consultar o QSA pela API da DataX

A [ficha do CNPJ](https://datax.plus/api-consulta-cnpj/) traz o quadro societário no campo `socios`, junto com os dados cadastrais da empresa. Cada consulta consome 1 requisição do limite diário.

```bash
curl https://api.datax.plus/v1/empresas/11222333000181 \
  -H "api-key: $DATAX_KEY"
```

```json
{
  "cnpj": "11222333000181",
  "razaoSocial": "EXEMPLO TECNOLOGIA LTDA",
  "socios": [
    {
      "nome": "JOÃO P. LIMA",
      "qualificacao": "Sócio-Administrador",
      "dataEntrada": "2015-06-02"
    }
  ]
}
```

O exemplo abaixo, em Python, ordena o quadro para deixar primeiro quem costuma responder pela empresa.

```python
import os
import requests

KEY = os.environ["DATAX_KEY"]
ORDEM = ["administrador", "presidente", "diretor", "titular", "sócio"]

def peso(socio):
    qualificacao = (socio.get("qualificacao") or "").lower()
    return next((i for i, termo in enumerate(ORDEM) if termo in qualificacao), len(ORDEM))

def quadro_societario(cnpj):
    r = requests.get(
        f"https://api.datax.plus/v1/empresas/{cnpj}",
        headers={"api-key": KEY},
        timeout=30,
    )
    r.raise_for_status()
    return sorted(r.json().get("socios") or [], key=peso)

for socio in quadro_societario("11222333000181"):
    print(socio.get("qualificacao"), "|", socio.get("nome"))
```

## Ficha do CNPJ ou consulta de sócios?

| O que comparar | Ficha do CNPJ | Consulta de sócios |
| --- | --- | --- |
| Endereço | `GET /v1/empresas/{cnpj}` | `POST /v1/empresas/{cnpj}/socios` |
| Traz o quadro societário | Sim | Só os sócios pessoa física |
| Traz o telefone e o e-mail de cada sócio | Não, só o contato da empresa | Sim |
| Traz os dados cadastrais da empresa | Sim | Não |
| Consumo | 1 requisição | 1 requisição por sócio retornado |

Um fluxo comum usa as duas: a ficha para qualificar a empresa e, se ela interessar, a [consulta de sócios](https://datax.plus/api-socios-cnpj/) para chegar ao contato. Se você só quer o contato, a consulta de sócios sozinha já resolve.

## Cuidados ao usar o QSA

- **Empresa sem sócio pessoa física.** Se todos os sócios forem pessoas jurídicas, como numa holding, a consulta de sócios pode voltar sem ninguém. Trate a lista vazia como um resultado normal.
- **MEI e empresário individual.** Essas empresas têm um único titular e não têm sócios, então o quadro pode vir vazio.
- **Mudanças recentes.** O QSA mostra o que foi registrado. Uma alteração de sócios pode levar um tempo até aparecer nas bases, então confirme com a empresa antes de uma decisão importante.
- **Dados pessoais.** Nome e CPF de sócios são dados pessoais, mesmo vindo de um cadastro público. Use os contatos com uma finalidade legítima e clara, ofereça a opção de sair da lista e evite disparos em massa. Na dúvida sobre a LGPD no seu caso, fale com o seu jurídico.

## Fontes

- Qualificações: [Ato Declaratório Executivo Cocad nº 2/2011](https://www.contabeis.com.br/legislacao/139687/ato-declaratorio-executivo-cocad-2-2011/), com as tabelas de natureza jurídica e qualificação da Receita Federal.
- Campos do quadro nos dados abertos: conferidos em 4 de novembro de 2026 em APIs públicas que repassam esses arquivos, como a [Minha Receita](https://docs.minhareceita.org/).

## Dúvidas sobre o QSA

### O que significa QSA?

QSA significa Quadro de Sócios e Administradores. É a parte do cadastro do CNPJ que lista as pessoas físicas e jurídicas que compõem a sociedade ou que têm poderes para administrá-la.

### O QSA é público?

Sim. A Receita Federal permite consultar o QSA de qualquer CNPJ pelo site e também publica os dados nos arquivos abertos do CNPJ. Nos arquivos abertos, o CPF dos sócios aparece parcialmente oculto.

### O QSA mostra a participação de cada sócio?

Não. O QSA mostra quem é sócio e a sua qualificação, mas não o percentual de cada um. Essa informação costuma estar no contrato social, registrado na Junta Comercial.

### O QSA traz o telefone dos sócios?

Não. O telefone e o e-mail do cadastro são os da empresa. Na DataX, a [consulta de sócios](https://datax.plus/api-socios-cnpj/) devolve os telefones e os e-mails de cada sócio pessoa física.

### MEI tem QSA?

O MEI tem um único titular e não pode ter sócios, então não há um quadro societário como o de uma sociedade limitada.

### Qual a diferença entre sócio e administrador no QSA?

O sócio tem participação na empresa. O administrador responde pela gestão e pode nem ser sócio. O Sócio-Administrador acumula os dois papéis.

## Consulte o QSA e o contato dos sócios com o teste grátis de 24 horas, sem cartão.

[Começar teste grátis](https://portal.datax.plus/auth/cadastro) [Ver a API de consulta de CNPJ](https://datax.plus/api-consulta-cnpj/)