# Participações Societárias do CPF (base Receita Federal)

> Mapeia as participações societárias de um CPF a partir do Quadro de Sócios e Administradores (QSA) da Receita Federal — empresas onde a pessoa é sócia, com qualificação, data de entrada e situação cadastral.

- **Consulta:** `vinculos-societarios-bases`
- **Categoria:** Pessoa Jurídica
- **Preço:** R$ 0,54 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/vinculos-societarios-bases`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/pessoa-juridica/vinculos-societarios-bases

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint mapeia as **participações societárias** de uma pessoa física a partir do CPF, consultando o **Quadro de Sócios e Administradores (QSA)** da Receita Federal. Retorna todas as empresas em que a pessoa figura como sócia ou administradora, com a qualificação do vínculo, a data de entrada na sociedade, a situação cadastral da empresa e a UF.
>
> É uma consulta essencial para:
> - **Diligência e KYC/KYB**: entender a exposição societária de um indivíduo antes de contratar ou conceder crédito.
> - **Análise de risco**: identificar empresas ligadas a um sócio e sua situação cadastral (ativa, baixada, etc.).
> - **Prevenção a fraudes**: cruzar identidade e vínculos empresariais em onboarding.
> - **Mapeamento de grupos econômicos**: descobrir a rede de empresas de uma pessoa.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/vinculos-societarios-bases?cpf=SEU_CPF"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/vinculos-societarios-bases",
    params={"cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/vinculos-societarios-bases");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | sim | CPF da pessoa física. Aceita com ou sem pontuação. É o único parâmetro necessário. | formato: 000.000.000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A consulta retorna os seguintes campos:
>
> | Campo | Tipo | Descrição |
> |-------|------|-----------|
> | `cpfConsultado` | string | CPF consultado (parcialmente mascarado). |
> | `nomeConsultado` | string | Nome do titular do CPF. |
> | `totalVinculos` | number | Quantidade de vínculos societários encontrados. |
> | `vinculos` | array | Lista das empresas em que a pessoa participa. |
> | `vinculos[].cnpj` | string | CNPJ da empresa. |
> | `vinculos[].razaoSocial` | string | Razão social da empresa. |
> | `vinculos[].nomeFantasia` | string | Nome fantasia da empresa, quando houver. |
> | `vinculos[].qualificacao` | string | Qualificação do vínculo (ex.: Sócio, Sócio-Administrador, Administrador). |
> | `vinculos[].qualificacaoCodigo` | string | Código oficial da qualificação do sócio. |
> | `vinculos[].dataEntrada` | string | Data de entrada na sociedade (AAAA-MM-DD). |
> | `vinculos[].situacaoCadastral` | string | Situação cadastral da empresa (ATIVA, BAIXADA, etc.). |
> | `vinculos[].uf` | string | UF da empresa. |
> | `safra` | string | Data de referência (safra) da base da Receita Federal utilizada na consulta. |

### Exemplo de resposta

```json
{
  "safra": "string",
  "vinculos": [
    {
      "uf": "string",
      "cnpj": "string",
      "dataEntrada": "string",
      "razaoSocial": "string",
      "nomeFantasia": "string",
      "qualificacao": "string",
      "situacaoCadastral": "string",
      "qualificacaoCodigo": "string"
    }
  ],
  "cpfConsultado": "string",
  "totalVinculos": "number",
  "nomeConsultado": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "safra": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de referência (safra) da base da Receita Federal utilizada na consulta."
    },
    "vinculos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "UF da empresa."
          },
          "cnpj": {
            "type": [
              "string",
              "null"
            ],
            "description": "CNPJ da empresa."
          },
          "dataEntrada": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de entrada na sociedade (AAAA-MM-DD)."
          },
          "razaoSocial": {
            "type": [
              "string",
              "null"
            ],
            "description": "Razão social da empresa."
          },
          "nomeFantasia": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome fantasia da empresa, quando houver."
          },
          "qualificacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Qualificação do vínculo (ex.: Sócio, Sócio-Administrador, Administrador)."
          },
          "situacaoCadastral": {
            "type": [
              "string",
              "null"
            ],
            "description": "Situação cadastral da empresa (ATIVA, BAIXADA, etc.)."
          },
          "qualificacaoCodigo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código oficial da qualificação do sócio."
          }
        }
      },
      "description": "Lista das empresas em que a pessoa participa."
    },
    "cpfConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF consultado (parcialmente mascarado)."
    },
    "totalVinculos": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade de vínculos societários encontrados."
    },
    "nomeConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do titular do CPF."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | CPF inválido | O CPF informado é inválido ou está ausente. Envie um CPF com 11 dígitos (com ou sem pontuação). |
| `401` | Não autenticado | Chave de API ausente ou inválida. Verifique o header X-API-Key. |
| `403` | Acesso negado | Saldo insuficiente ou sua chave não tem permissão para esta consulta. |
| `404` | CPF não encontrado | O CPF consultado não foi localizado para enriquecimento do nome do titular. |
| `408` | Tempo esgotado | A consulta demorou mais que o esperado para responder. Tente novamente em alguns instantes. |
| `500` | Falha na consulta | Não foi possível concluir a consulta. Se o problema persistir, entre em contato com o suporte. |
| `503` | Consulta em manutenção | Esta consulta está temporariamente em manutenção. Tente novamente mais tarde. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - O dado tem uma **safra de referência**, identificada pelo campo `safra`.
> - Quando não há vínculos, o endpoint retorna `totalVinculos: 0` e `vinculos: []` com HTTP 200 (não é erro).

---

Página em HTML: https://fontedata.com/docs/pessoa-juridica/vinculos-societarios-bases
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp