# Vínculos Societários

> Mapeia a rede de vínculos societários e de parentesco de um CPF ou CNPJ, em vários níveis de profundidade, com o documento completo de cada pessoa ou empresa ligada.

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Mapeia a rede de vínculos de uma pessoa física ou jurídica em vários níveis de profundidade. A resposta é uma **árvore**: cada vínculo pode ter os seus próprios vínculos, e o documento (CPF ou CNPJ) de cada entidade ligada vem **completo**, o que permite seguir a cadeia em novas consultas.
>
> São dois tipos de vínculo, e vale conhecer os dois antes de usar:
>
> - **Sociedade** — participação societária ou cargo de administração. Cerca de 76% dos vínculos retornados.
> - **Parentesco** — laço familiar (mãe, pai, irmão, filho, cônjuge, tio, avó e outros). Cerca de 24% dos vínculos retornados.
>
> O vínculo de parentesco vem acompanhado do **CPF completo do familiar**. Trate a resposta como dado pessoal e observe a finalidade declarada no seu tratamento.
>
> Útil para due diligence, análise de risco de crédito, prevenção à lavagem de dinheiro e mapeamento de estrutura corporativa.

## Requisição

### cURL

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/vinculos-societarios",
    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");

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

Informe `cpf` ou `cnpj`.

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | condicional | CPF a consultar, com ou sem máscara (`00000000000` ou `000.000.000-00`). O dígito verificador é validado antes da consulta. Envie o nome do parâmetro em minúsculas. | formato: 000.000.000-00 |
| `cnpj` | CNPJ | condicional | CNPJ a consultar, com ou sem máscara (`00000000000000` ou `00.000.000/0000-00`). O dígito verificador é validado antes da consulta. Envie o nome do parâmetro em minúsculas. | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> ### A árvore de relacionamentos
>
> `relacionamentos` é uma lista **recursiva**: cada item pode conter o seu próprio `relacionamentos`. O campo `nivel` é um **número inteiro** igual à profundidade do item na árvore — `1` é o vínculo direto com o documento consultado. Observamos profundidade de até **8**, e mais de 60% das respostas passam do nível 3. Percorra a estrutura recursivamente; não presuma um número fixo de níveis.
>
> Quando não há vínculo registrado, `relacionamentos` vem como lista vazia.
>
> ### Tipo e grau do vínculo
>
> `tipo` assume **exatamente dois valores**: `Sociedade` ou `Parentesco`.
>
> `grau` diz **qual** é o vínculo, e o seu significado depende do `tipo`:
>
> - com `tipo = "Sociedade"`, traz o papel exercido: `Sócio Administrador`, `Administrador`, `Sócio`, `Diretor`, `Sócio Gerente`, `Conselheiro de Administração`, entre outros. Vem nulo em cerca de 7% dos casos.
> - com `tipo = "Parentesco"`, traz o laço familiar: `Mãe`, `Pai`, `Irmão`, `Irmã`, `Filho`, `Filha`, `Conjuge`, `Tio`, `Avó`, `Sobrinho`, `Primo`, `Sogra`, entre outros.
>
> Os valores de `grau` e de `cargo` chegam **como estão na origem e não são normalizados**: podem vir com prefixo numérico (`59-Produtor Rural`), espaçamento irregular ou variação de caixa. Compare por conteúdo, não por igualdade exata.
>
> ### Vigência e histórico
>
> `status` indica se o vínculo está **vigente** (`true`) ou **encerrado** (`false`). Em vínculo de parentesco `status` é sempre `true` e não carrega informação — ignore-o nesse caso.
>
> `historicos` detalha os períodos de cada cargo e vem **vazio em todo vínculo de parentesco**. Dentro de cada registro, `status = false` significa cargo encerrado e coincide sempre com `dataFim` preenchida.
>
> **As datas são esparsas:** `dataInicio` vem em cerca de 19% dos registros e `dataFim` em cerca de 16%. A origem não informa o período da maioria dos vínculos — não construa linha do tempo assumindo que as datas existem.
>
> ### Formato das datas e dos documentos
>
> Todas as datas desta consulta vêm no formato **`DD/MM/AAAA HH:MM:SS`** (a hora é sempre `00:00:00`). Vale para `dataInicio`, `dataFim`, `dataNascimento`, `dataAbertura` e `dataEncerramento`.
>
> Os documentos vêm completos e **com máscara**: CPF como `000.000.000-00` e CNPJ como `00.000.000/0000-00`. Remova a pontuação se precisar apenas dos dígitos.
>
> ### Detalhes por entidade
>
> `detalhesPessoaFisica` e `detalhesPessoaJuridica` são complementos **opcionais**. Em cerca de **dois terços dos vínculos nenhum dos dois vem preenchido** — trate ambos como possivelmente nulos.
>
> Em `detalhesPessoaFisica` (presente em ~24% dos vínculos), `pep`, `obito` e `dataNascimento` vêm em torno de 90% das vezes. Já `endereco` e `situacaoCadastral` **quase nunca vêm** (~2%): não dependa deles.
>
> Em `detalhesPessoaJuridica` (presente em ~9% dos vínculos), `situacaoCadastral`, `dataAbertura`, `endereco`, `matriz` e `baixada` vêm em mais de 99% das vezes. Dois cuidados:
>
> - **`baixada = true` significa estritamente situação `BAIXADA`.** Empresa `INAPTA` ou `SUSPENSA` vem com `baixada = false`. Para triar empresa irregular, leia `situacaoCadastral`, não `baixada`.
> - **`recuperacaoJudicial` vem `false` em praticamente toda a base** e não deve ser usado como triagem de recuperação judicial.
>
> ### Consulta por CNPJ entrega menos que por CPF
>
> Por CPF a resposta traz tipicamente 6 vínculos diretos e 23 nós no total. Por CNPJ, tipicamente 1 vínculo direto e 5 nós. Além disso, quase metade dos vínculos retornados numa consulta por CNPJ é de **parentesco dos sócios**, não de sociedade. Se o objetivo é mapear o entorno de uma empresa, consultar os CPFs dos sócios rende mais.

### Exemplo de resposta

```json
{
  "nomeEntidade": "***",
  "relacionamentos": [
    {
      "grau": "Sócio Administrador",
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "66.666.666/0001-66",
      "historicos": [
        {
          "cargo": "Sócio Administrador",
          "status": true,
          "dataFim": null,
          "dataInicio": "10/05/2024 00:00:00"
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": "Sócio Administrador",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": "Sócio Administrador",
              "status": true,
              "dataFim": null,
              "dataInicio": "10/05/2024 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": false,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "553",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "03/08/2012 00:00:00",
        "dataEncerramento": null,
        "situacaoCadastral": "ATIVA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "55.555.555/0001-55",
      "historicos": [
        {
          "cargo": null,
          "status": true,
          "dataFim": null,
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": {
            "pep": false,
            "obito": false,
            "endereco": null,
            "dataNascimento": "***",
            "situacaoCadastral": null
          },
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "S/N",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "01/06/1994 00:00:00",
        "dataEncerramento": "31/12/2008 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "33.333.333/0001-33",
      "historicos": [
        {
          "cargo": null,
          "status": true,
          "dataFim": null,
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "CUIABA",
          "numero": "140",
          "logradouro": "***",
          "complemento": "***"
        },
        "dataAbertura": "08/08/1984 00:00:00",
        "dataEncerramento": "30/06/1999 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "77.777.777/0001-77",
      "historicos": [
        {
          "cargo": null,
          "status": true,
          "dataFim": null,
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "CUIABA",
          "numero": "140",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "09/01/1996 00:00:00",
        "dataEncerramento": "30/06/1999 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": "Sócio",
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "44.444.444/0001-44",
      "historicos": [
        {
          "cargo": "Sócio",
          "status": true,
          "dataFim": null,
          "dataInicio": "05/07/1999 00:00:00"
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": "Sócio Administrador",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": "Sócio Administrador",
              "status": true,
              "dataFim": null,
              "dataInicio": "05/07/1999 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": "Sócio",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": "Sócio",
              "status": true,
              "dataFim": null,
              "dataInicio": "05/07/1999 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "CUIABA",
          "numero": "S/N",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "05/07/1999 00:00:00",
        "dataEncerramento": "31/12/2008 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": false,
      "documento": "11.111.111/0001-11",
      "historicos": [
        {
          "cargo": null,
          "status": false,
          "dataFim": "10/09/2024 02:49:58",
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": "Sócio Administrador",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": "Sócio Administrador",
              "status": true,
              "dataFim": null,
              "dataInicio": "05/07/1999 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": false,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": false,
              "dataFim": "10/09/2024 02:49:58",
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": false,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "2323",
          "logradouro": "***",
          "complemento": "***"
        },
        "dataAbertura": "05/07/1999 00:00:00",
        "dataEncerramento": null,
        "situacaoCadastral": "INAPTA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": false,
      "documento": "22.222.222/0001-22",
      "historicos": [
        {
          "cargo": null,
          "status": false,
          "dataFim": "10/09/2024 02:49:47",
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": "Sócio Administrador",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": "Sócio Administrador",
              "status": true,
              "dataFim": null,
              "dataInicio": "18/08/1999 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": false,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": false,
              "dataFim": "10/09/2024 02:49:47",
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": false,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "1.480",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "18/08/1999 00:00:00",
        "dataEncerramento": null,
        "situacaoCadastral": "ATIVA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": "Sócio",
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "66.666.666/0001-66",
      "historicos": [
        {
          "cargo": "Sócio",
          "status": true,
          "dataFim": null,
          "dataInicio": "18/08/1999 00:00:00"
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": "Sócio Administrador",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": "Sócio Administrador",
              "status": true,
              "dataFim": null,
              "dataInicio": "18/08/1999 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": "Sócio",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": "Sócio",
              "status": true,
              "dataFim": null,
              "dataInicio": "18/08/1999 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "CUIABA",
          "numero": "140",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "18/08/1999 00:00:00",
        "dataEncerramento": "09/02/2015 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "55.555.555/0001-55",
      "historicos": [
        {
          "cargo": null,
          "status": true,
          "dataFim": null,
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "999.999.999-99",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": {
            "pep": false,
            "obito": false,
            "endereco": null,
            "dataNascimento": "***",
            "situacaoCadastral": null
          },
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "1480",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "20/03/1980 00:00:00",
        "dataEncerramento": "20/12/1996 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "33.333.333/0001-33",
      "historicos": [
        {
          "cargo": null,
          "status": true,
          "dataFim": null,
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "999.999.999-99",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "222.222.222-22",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": {
            "pep": false,
            "obito": false,
            "endereco": null,
            "dataNascimento": "***",
            "situacaoCadastral": null
          },
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "NOSSA SENHORA DO LIVRAMENTO",
          "numero": "S/N",
          "logradouro": "***",
          "complemento": "***"
        },
        "dataAbertura": "14/03/1988 00:00:00",
        "dataEncerramento": "20/12/1996 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "77.777.777/0001-77",
      "historicos": [
        {
          "cargo": null,
          "status": true,
          "dataFim": null,
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "999.999.999-99",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "777.777.777-77",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [
            {
              "grau": "Filho",
              "tipo": "Parentesco",
              "nivel": 3,
              "status": true,
              "documento": "888.888.888-88",
              "historicos": [],
              "nomeEntidade": "***",
              "relacionamentos": [],
              "detalhesPessoaFisica": {
                "pep": false,
                "obito": false,
                "endereco": null,
                "dataNascimento": "***",
                "situacaoCadastral": null
              },
              "detalhesPessoaJuridica": null
            },
            {
              "grau": "Filha",
              "tipo": "Parentesco",
              "nivel": 3,
              "status": true,
              "documento": "333.333.333-33",
              "historicos": [],
              "nomeEntidade": "***",
              "relacionamentos": [],
              "detalhesPessoaFisica": {
                "pep": false,
                "obito": false,
                "endereco": null,
                "dataNascimento": "***",
                "situacaoCadastral": null
              },
              "detalhesPessoaJuridica": null
            },
            {
              "grau": "Neta(O)",
              "tipo": "Parentesco",
              "nivel": 3,
              "status": true,
              "documento": "666.666.666-66",
              "historicos": [],
              "nomeEntidade": "***",
              "relacionamentos": [],
              "detalhesPessoaFisica": {
                "pep": false,
                "obito": false,
                "endereco": null,
                "dataNascimento": "***",
                "situacaoCadastral": null
              },
              "detalhesPessoaJuridica": null
            }
          ],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "222.222.222-22",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "2563",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "13/01/1988 00:00:00",
        "dataEncerramento": "31/12/2008 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "44.444.444/0001-44",
      "historicos": [
        {
          "cargo": null,
          "status": true,
          "dataFim": null,
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "999.999.999-99",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "777.777.777-77",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": {
            "pep": false,
            "obito": false,
            "endereco": null,
            "dataNascimento": "***",
            "situacaoCadastral": null
          },
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "222.222.222-22",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": "Sócio",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "555.555.555-55",
          "historicos": [
            {
              "cargo": "Sócio",
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": {
            "pep": false,
            "obito": false,
            "endereco": null,
            "dataNascimento": "***",
            "situacaoCadastral": null
          },
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "1480",
          "logradouro": "***",
          "complemento": "***"
        },
        "dataAbertura": "25/03/1993 00:00:00",
        "dataEncerramento": "30/06/1999 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "11.111.111/0001-11",
      "historicos": [
        {
          "cargo": null,
          "status": true,
          "dataFim": null,
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "999.999.999-99",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "777.777.777-77",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "222.222.222-22",
          "historicos": [
            {
              "cargo": null,
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": "Sócio",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "555.555.555-55",
          "historicos": [
            {
              "cargo": "Sócio",
              "status": true,
              "dataFim": null,
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": false,
        "baixada": true,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "2323",
          "logradouro": "***",
          "complemento": null
        },
        "dataAbertura": "18/03/1994 00:00:00",
        "dataEncerramento": "30/06/1999 00:00:00",
        "situacaoCadastral": "BAIXADA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": null,
      "tipo": "Sociedade",
      "nivel": 1,
      "status": false,
      "documento": "22.222.222/0001-22",
      "historicos": [
        {
          "cargo": null,
          "status": false,
          "dataFim": "10/09/2024 02:49:58",
          "dataInicio": null
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": false,
          "documento": "999.999.999-99",
          "historicos": [
            {
              "cargo": null,
              "status": false,
              "dataFim": "10/09/2024 02:49:58",
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": false,
          "documento": "777.777.777-77",
          "historicos": [
            {
              "cargo": null,
              "status": false,
              "dataFim": "10/09/2024 02:49:58",
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": "Sócio Administrador",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": "Sócio Administrador",
              "status": true,
              "dataFim": null,
              "dataInicio": "01/03/2023 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": false,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": null,
              "status": false,
              "dataFim": "10/09/2024 02:49:58",
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": false,
          "documento": "222.222.222-22",
          "historicos": [
            {
              "cargo": null,
              "status": false,
              "dataFim": "10/09/2024 02:49:58",
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": false,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "650",
          "logradouro": "***",
          "complemento": "***"
        },
        "dataAbertura": "01/03/2023 00:00:00",
        "dataEncerramento": null,
        "situacaoCadastral": "ATIVA",
        "recuperacaoJudicial": false
      }
    },
    {
      "grau": "Sócio Administrador",
      "tipo": "Sociedade",
      "nivel": 1,
      "status": true,
      "documento": "66.666.666/0001-66",
      "historicos": [
        {
          "cargo": "Sócio Administrador",
          "status": true,
          "dataFim": null,
          "dataInicio": "04/12/2002 00:00:00"
        }
      ],
      "nomeEntidade": "***",
      "relacionamentos": [
        {
          "grau": null,
          "tipo": "Sociedade",
          "nivel": 2,
          "status": false,
          "documento": "444.444.444-44",
          "historicos": [
            {
              "cargo": null,
              "status": false,
              "dataFim": "10/09/2024 02:50:08",
              "dataInicio": null
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": "Sócio Administrador",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "111.111.111-11",
          "historicos": [
            {
              "cargo": "Sócio Administrador",
              "status": true,
              "dataFim": null,
              "dataInicio": "04/12/2002 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        },
        {
          "grau": "Sócio",
          "tipo": "Sociedade",
          "nivel": 2,
          "status": true,
          "documento": "555.555.555-55",
          "historicos": [
            {
              "cargo": "Sócio",
              "status": true,
              "dataFim": null,
              "dataInicio": "09/06/2006 00:00:00"
            }
          ],
          "nomeEntidade": "***",
          "relacionamentos": [],
          "detalhesPessoaFisica": null,
          "detalhesPessoaJuridica": null
        }
      ],
      "detalhesPessoaFisica": null,
      "detalhesPessoaJuridica": {
        "matriz": true,
        "baixada": false,
        "endereco": {
          "uf": "MT",
          "cep": "***",
          "bairro": "***",
          "cidade": "VARZEA GRANDE",
          "numero": "1.480",
          "logradouro": "***",
          "complemento": "***"
        },
        "dataAbertura": "04/12/2002 00:00:00",
        "dataEncerramento": null,
        "situacaoCadastral": "ATIVA",
        "recuperacaoJudicial": false
      }
    }
  ],
  "documentoConsultado": "111.111.111-11",
  "detalhesPessoaFisica": {
    "pep": false,
    "obito": false,
    "endereco": null,
    "dataNascimento": "***",
    "situacaoCadastral": null
  },
  "detalhesPessoaJuridica": null
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "nomeEntidade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome completo da pessoa física ou razão social da entidade consultada."
    },
    "relacionamentos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "grau": {
            "type": [
              "string",
              "null"
            ],
            "description": "Qual é o vínculo, e depende do `tipo`: com `Sociedade` traz o papel exercido (`Sócio Administrador`, `Administrador`, `Sócio`, `Diretor` e outros); com `Parentesco` traz o laço (`Mãe`, `Pai`, `Irmão`, `Filho`, `Conjuge`, `Tio`, `Avó` e outros). Chega como está na origem, sem normalização: pode vir com prefixo numérico ou espaçamento irregular. Nulo em cerca de 7% dos vínculos societários."
          },
          "tipo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo do vínculo. Assume exatamente dois valores: `Sociedade` (participação societária ou cargo de administração) ou `Parentesco` (laço familiar)."
          },
          "nivel": {
            "type": [
              "number",
              "null"
            ],
            "description": "Profundidade do item na árvore, começando em 1 para o vínculo direto com o documento consultado. Foi observada profundidade de até 8."
          },
          "status": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "`true` indica vínculo vigente e `false` indica vínculo encerrado. Em vínculo de parentesco vem sempre `true` e não carrega informação."
          },
          "documento": {
            "type": [
              "string",
              "null"
            ],
            "description": "CPF ou CNPJ completo da entidade relacionada, sempre com máscara (`000.000.000-00` ou `00.000.000/0000-00`)."
          },
          "historicos": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "cargo": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Cargo ou função exercida. Preenchido em cerca de 93% dos registros."
                },
                "status": {
                  "type": [
                    "boolean",
                    "null"
                  ],
                  "description": "`true` indica cargo em exercício e `false` indica cargo encerrado. `false` coincide sempre com `dataFim` preenchida."
                },
                "dataFim": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Data de término do cargo, no formato `DD/MM/AAAA HH:MM:SS`. Preenchida em cerca de 16% dos registros; quando vem, o cargo está encerrado."
                },
                "dataInicio": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Data de início do cargo, no formato `DD/MM/AAAA HH:MM:SS`. A origem informa esta data em apenas cerca de 19% dos registros — trate a ausência como normal."
                }
              }
            },
            "description": "Períodos de cada cargo exercido. Vem vazio em todo vínculo de parentesco. As datas são esparsas — ver os campos abaixo."
          },
          "nomeEntidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome completo ou razão social da entidade relacionada."
          },
          "relacionamentos": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object"
            },
            "description": "Vínculos do nível seguinte, com a mesma estrutura deste objeto. É o que torna a resposta uma árvore — percorra recursivamente."
          },
          "detalhesPessoaFisica": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "pep": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Indica pessoa exposta politicamente. Preenchido em cerca de 87% dos casos em que este objeto vem."
              },
              "obito": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Indica óbito registrado. Preenchido em cerca de 92% dos casos em que este objeto vem."
              },
              "endereco": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Endereço da pessoa física. **Quase nunca vem preenchido** (cerca de 2%) — não construa fluxo que dependa dele."
              },
              "dataNascimento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de nascimento, no formato `DD/MM/AAAA HH:MM:SS` (a hora é sempre `00:00:00`). Preenchida em cerca de 91% dos casos em que este objeto vem."
              },
              "situacaoCadastral": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Situação cadastral do CPF. **Quase nunca vem preenchida** (cerca de 2%) e a caixa do texto varia (`Regular`, `REGULAR`) — compare sem diferenciar maiúsculas de minúsculas."
              }
            },
            "description": "Complemento sobre a pessoa física. Opcional: em cerca de dois terços dos vínculos nem este objeto nem `detalhesPessoaJuridica` vêm preenchidos."
          },
          "detalhesPessoaJuridica": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "matriz": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Indica estabelecimento matriz, correspondendo à ordem `0001` do CNPJ."
              },
              "baixada": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Indica **estritamente** situação cadastral `BAIXADA`. Empresa `INAPTA` ou `SUSPENSA` vem com `baixada = false` — não use este campo como sinônimo de inativa; leia `situacaoCadastral`."
              },
              "endereco": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "uf": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Unidade federativa."
                  },
                  "cep": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "CEP do endereço."
                  },
                  "bairro": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Bairro."
                  },
                  "cidade": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Cidade."
                  },
                  "numero": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Número do endereço."
                  },
                  "logradouro": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Logradouro."
                  },
                  "complemento": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Complemento do endereço."
                  }
                },
                "description": "Endereço da empresa. Vem preenchido em mais de 99% dos casos em que este objeto vem."
              },
              "dataAbertura": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de abertura da empresa, no formato `DD/MM/AAAA HH:MM:SS`."
              },
              "dataEncerramento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de encerramento, no formato `DD/MM/AAAA HH:MM:SS`. Vem preenchida somente quando a empresa está baixada."
              },
              "situacaoCadastral": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Situação cadastral do CNPJ: `ATIVA`, `BAIXADA`, `INAPTA` ou `SUSPENSA`. É o campo correto para triar empresa irregular."
              },
              "recuperacaoJudicial": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Indicador de recuperação judicial. Vem `false` em praticamente toda a base — **não serve como triagem de recuperação judicial**, use uma consulta dedicada."
              }
            },
            "description": "Complemento sobre a pessoa jurídica. Opcional: em cerca de dois terços dos vínculos nem este objeto nem `detalhesPessoaFisica` vêm preenchidos."
          }
        }
      },
      "description": "Árvore de vínculos. Lista recursiva: cada item pode conter o seu próprio `relacionamentos`. Vem vazia quando não há vínculo registrado para o documento."
    },
    "documentoConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Documento (CPF ou CNPJ) consultado, com máscara."
    },
    "detalhesPessoaFisica": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "pep": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica pessoa exposta politicamente. Preenchido em cerca de 87% dos casos em que este objeto vem."
        },
        "obito": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica óbito registrado. Preenchido em cerca de 92% dos casos em que este objeto vem."
        },
        "endereco": {
          "type": [
            "object",
            "null"
          ],
          "description": "Endereço da pessoa física. **Quase nunca vem preenchido** (cerca de 2%) — não construa fluxo que dependa dele."
        },
        "dataNascimento": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data de nascimento, no formato `DD/MM/AAAA HH:MM:SS` (a hora é sempre `00:00:00`). Preenchida em cerca de 91% dos casos em que este objeto vem."
        },
        "situacaoCadastral": {
          "type": [
            "string",
            "null"
          ],
          "description": "Situação cadastral do CPF. **Quase nunca vem preenchida** (cerca de 2%) e a caixa do texto varia (`Regular`, `REGULAR`) — compare sem diferenciar maiúsculas de minúsculas."
        }
      },
      "description": "Complemento sobre a pessoa física. Opcional: em cerca de dois terços dos vínculos nem este objeto nem `detalhesPessoaJuridica` vêm preenchidos."
    },
    "detalhesPessoaJuridica": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "matriz": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica estabelecimento matriz, correspondendo à ordem `0001` do CNPJ."
        },
        "baixada": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica **estritamente** situação cadastral `BAIXADA`. Empresa `INAPTA` ou `SUSPENSA` vem com `baixada = false` — não use este campo como sinônimo de inativa; leia `situacaoCadastral`."
        },
        "endereco": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "uf": {
              "type": [
                "string",
                "null"
              ],
              "description": "Unidade federativa."
            },
            "cep": {
              "type": [
                "string",
                "null"
              ],
              "description": "CEP do endereço."
            },
            "bairro": {
              "type": [
                "string",
                "null"
              ],
              "description": "Bairro."
            },
            "cidade": {
              "type": [
                "string",
                "null"
              ],
              "description": "Cidade."
            },
            "numero": {
              "type": [
                "string",
                "null"
              ],
              "description": "Número do endereço."
            },
            "logradouro": {
              "type": [
                "string",
                "null"
              ],
              "description": "Logradouro."
            },
            "complemento": {
              "type": [
                "string",
                "null"
              ],
              "description": "Complemento do endereço."
            }
          },
          "description": "Endereço da empresa. Vem preenchido em mais de 99% dos casos em que este objeto vem."
        },
        "dataAbertura": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data de abertura da empresa, no formato `DD/MM/AAAA HH:MM:SS`."
        },
        "dataEncerramento": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data de encerramento, no formato `DD/MM/AAAA HH:MM:SS`. Vem preenchida somente quando a empresa está baixada."
        },
        "situacaoCadastral": {
          "type": [
            "string",
            "null"
          ],
          "description": "Situação cadastral do CNPJ: `ATIVA`, `BAIXADA`, `INAPTA` ou `SUSPENSA`. É o campo correto para triar empresa irregular."
        },
        "recuperacaoJudicial": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indicador de recuperação judicial. Vem `false` em praticamente toda a base — **não serve como triagem de recuperação judicial**, use uma consulta dedicada."
        }
      },
      "description": "Complemento sobre a pessoa jurídica. Opcional: em cerca de dois terços dos vínculos nem este objeto nem `detalhesPessoaFisica` vêm preenchidos."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `200` | Consulta sem resultado | o documento é válido mas não há nenhum vínculo registrado para ele. A resposta vem com `found: false` e **é cobrada**, porque a consulta foi executada na origem. |
| `400` | Requisição Inválida | os parâmetros estão incorretos — nome do parâmetro em maiúsculas (`CPF` em vez de `cpf`), documento com dígito verificador inválido, nenhum documento informado ou os dois ao mesmo tempo. |
| `401` | Não Autenticado | a chave de API não foi enviada ou não é válida. |
| `403` | Não Autorizado | a requisição está correta, mas a conta não tem saldo disponível para a consulta. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição. Entre em contato com o nosso suporte. |
| `502` | Tempo Excedido na Origem | a origem não respondeu no prazo. Ocorre em cerca de 5% das consultas por CPF, em rajadas de instabilidade — **reenvie a mesma consulta**, que costuma responder normalmente na nova tentativa. Consulta que falha não é cobrada. |
| `504` | Tempo Excedido na Origem | mesma causa do 502: a origem não respondeu no prazo. Reenvie a mesma consulta. Consulta que falha não é cobrada. |
| `503` | Consulta em Manutenção | a consulta está temporariamente em manutenção. Entre em contato com o nosso suporte. |

## Quando usar

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Due diligence de contraparte, para enxergar o entorno societário e familiar antes de contratar.
> - Análise de risco de crédito, para identificar grupo econômico de fato por trás de um CPF ou CNPJ.
> - Prevenção à lavagem de dinheiro e integridade, com o documento completo de cada ligado para checar sanções, mídia adversa e exposição política em consultas dedicadas.
> - Investigação de estrutura em camadas, seguindo a árvore nível a nível.

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - **Os documentos do exemplo de resposta são fictícios** e servem apenas para ilustrar a estrutura. Não correspondem a pessoas ou empresas reais.
> - Envie apenas um documento por requisição (CPF **ou** CNPJ, nunca os dois).
> - O tempo de resposta acompanha o tamanho da rede: até 100 nós a resposta sai em torno de 2,5s; acima de 1.000 nós a mediana passa de 12s, com casos de 38s. Dimensione o timeout do seu cliente em pelo menos 60s.
> - Esta consulta devolve **CPF completo de familiares** do titular consultado. Trate o retorno como dado pessoal sensível.
> - Combine com consultas de sanções, mídia adversa e processos para compor o perfil de risco — esta consulta responde *quem* está ligado a quem, não a reputação de cada ligado.

---

Página em HTML: https://fontedata.com/docs/pessoa-juridica/vinculos-societarios
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
