Dados cadastrais

Vínculos Societários - CNPJ

Mapeia os vínculos societários da empresa: participação em sociedades, cargos e empresas coligadas e controladas.

Quando usar

Descrição

O serviço Vínculos Societários identifica as sociedades em que a empresa consultada participa, com o nível e o grau de cada vínculo, a situação (ativo ou inativo) e o histórico de cargos com as datas de início e fim.

Para cada pessoa ou empresa vinculada são apresentados a situação cadastral, a indicação de PEP e de óbito (pessoa física) ou a data de abertura, baixa e recuperação judicial (pessoa jurídica), além do endereço. Os vínculos de níveis seguintes são exibidos de forma aninhada.

Casos de uso

Due diligence de clientes e fornecedores, PLD/FT, mapeamento de grupo econômico e análise de crédito.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/empresas/vinculos-societarios-cnpj

Campo	Obrigatório	Descrição
`document`	sim	CNPJ da empresa, com ou sem máscara.

{
  "document": "00.000.000/0000-00"
}

Campos de retorno

Campos dentro de data. [] indica lista.

Campo	Tipo
`documentoConsultado`	texto
`nomeEntidade`	texto
`detalhesPessoaFisica`	texto
`detalhesPessoaJuridica.matriz`	booleano
`detalhesPessoaJuridica.dataAbertura`	texto
`detalhesPessoaJuridica.baixada`	booleano
`detalhesPessoaJuridica.dataEncerramento`	texto
`detalhesPessoaJuridica.recuperacaoJudicial`	booleano
`detalhesPessoaJuridica.situacaoCadastral`	texto
`detalhesPessoaJuridica.endereco.logradouro`	texto
`detalhesPessoaJuridica.endereco.numero`	texto
`detalhesPessoaJuridica.endereco.complemento`	texto
`detalhesPessoaJuridica.endereco.bairro`	texto
`detalhesPessoaJuridica.endereco.cidade`	texto
`detalhesPessoaJuridica.endereco.uf`	texto
`detalhesPessoaJuridica.endereco.cep`	texto
`relacionamentos[].documento`	texto
`relacionamentos[].nomeEntidade`	texto
`relacionamentos[].detalhesPessoaFisica.pep`	booleano
`relacionamentos[].detalhesPessoaFisica.dataNascimento`	texto
`relacionamentos[].detalhesPessoaFisica.obito`	booleano
`relacionamentos[].detalhesPessoaFisica.situacaoCadastral`	texto
`relacionamentos[].detalhesPessoaJuridica`	texto
`relacionamentos[].nivel`	número
`relacionamentos[].tipo`	texto
`relacionamentos[].grau`	texto
`relacionamentos[].status`	booleano
`relacionamentos[].historicos[].cargo`	texto
`relacionamentos[].historicos[].status`	booleano
`relacionamentos[].historicos[].dataInicio`	texto
`relacionamentos[].historicos[].dataFim`	texto
`relacionamentos[].relacionamentos[].documento`	texto
`relacionamentos[].relacionamentos[].nomeEntidade`	texto
`relacionamentos[].relacionamentos[].detalhesPessoaFisica.pep`	booleano
`relacionamentos[].relacionamentos[].detalhesPessoaFisica.dataNascimento`	texto
`relacionamentos[].relacionamentos[].detalhesPessoaFisica.obito`	booleano
`relacionamentos[].relacionamentos[].detalhesPessoaFisica.situacaoCadastral`	texto
`relacionamentos[].relacionamentos[].detalhesPessoaJuridica`	texto
`relacionamentos[].relacionamentos[].nivel`	número
`relacionamentos[].relacionamentos[].tipo`	texto
`relacionamentos[].relacionamentos[].grau`	texto
`relacionamentos[].relacionamentos[].status`	booleano
`quantidade_vinculos`	número
`quantidade_vinculos_ativos`	número
`quantidade_total_vinculos`	número
`possui_pep_vinculado`	booleano

Exemplo de resposta

Estrutura real da resposta, com valores fictícios.

{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Vínculos Societários - CNPJ",
  "query_slug": "vinculos-societarios-cnpj",
  "data": {
    "documentoConsultado": "texto",
    "nomeEntidade": "texto",
    "detalhesPessoaFisica": null,
    "detalhesPessoaJuridica": {
      "matriz": false,
      "dataAbertura": "texto",
      "baixada": false,
      "dataEncerramento": null,
      "recuperacaoJudicial": false,
      "situacaoCadastral": "texto",
      "endereco": {
        "logradouro": "texto",
        "numero": "texto",
        "complemento": "texto",
        "bairro": "texto",
        "cidade": "texto",
        "uf": "texto",
        "cep": "texto"
      }
    },
    "relacionamentos": [
      {
        "documento": "texto",
        "nomeEntidade": "texto",
        "detalhesPessoaFisica": {
          "pep": false,
          "dataNascimento": "texto",
          "obito": false,
          "situacaoCadastral": null
        },
        "detalhesPessoaJuridica": null,
        "nivel": 0,
        "tipo": "texto",
        "grau": "texto",
        "status": false,
        "historicos": [
          {
            "cargo": "texto",
            "status": false,
            "dataInicio": "texto",
            "dataFim": null
          }
        ],
        "relacionamentos": [
          {
            "documento": "texto",
            "nomeEntidade": "texto",
            "detalhesPessoaFisica": {
              "pep": false,
              "dataNascimento": "texto",
              "obito": false,
              "situacaoCadastral": null
            },
            "detalhesPessoaJuridica": null,
            "nivel": 0,
            "tipo": "texto",
            "grau": "texto",
            "status": false,
            "historicos": [

            ],
            "relacionamentos": [

            ]
          }
        ]
      }
    ],
    "quantidade_vinculos": 0,
    "quantidade_vinculos_ativos": 0,
    "quantidade_total_vinculos": 0,
    "possui_pep_vinculado": false
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "5.000"
}

Cobrança e respostas

O valor é cobrado por consulta bem-sucedida.
200 — consulta processada (veja status no corpo da resposta)
401 — token ausente, inválido, inativo ou expirado
403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
429 — limite de requisições por minuto da chave excedido
504 — tempo máximo de execução do serviço excedido