Sócios e relacionamentos

Esta categoria reúne consultas para entender quem está por trás de uma empresa, quais vínculos existem entre pessoas e CNPJs, e quais riscos aparecem no entorno societário. Ela é útil para onboarding PJ, análise de beneficiário final, KYC de sócios, avaliação de relacionamentos econômicos e investigação de vínculos relevantes. Todos os serviços desta categoria são consumidos pelo endpoint:

POST /api/service-api

Quando usar

Use esta categoria quando precisar:

identificar proprietários, representantes e vínculos de uma empresa;
mapear pessoas físicas relacionadas ao CNPJ em primeiro nível;
consultar o quadro societário-administrativo (QSA) completo da matriz na Receita Federal;
mapear o grupo econômico e inferir o nível de influência do quadro societário;
avaliar processos judiciais associados aos sócios, individualmente ou de forma agregada;
consultar indicadores de PEP, sanções e histórico de compliance dos sócios.

Serviços disponíveis

Serviço	Código `service`	Uso principal
Relacionamentos de uma empresa	`SERVICE_COMPANY_RELATIONSHIP`	Retorna vínculos da empresa, incluindo proprietários, empregados, empresas possuídas e relacionamentos com pessoas
Sócios na Receita Federal	`SERVICE_COMPANY_RFB_OWNERS`	Retorna dados cadastrais dos sócios identificados na Receita Federal
Sócios de primeiro nível	`SERVICE_FIRST_LEVEL_PARTNER`	Resume círculos de pessoas físicas relacionadas ao CNPJ, com métricas de idade, renda, localização, processos e distribuições
Receita Federal - QSA	`SERVICE_RF_QSA`	Consulta o quadro societário-administrativo do CNPJ, com dados cadastrais da matriz e a lista de sócios e administradores
Relacionamentos do Grupo Econômico	`SERVICE_ECONOMIC_GROUP_RELATIONSHIPS`	Consulta entidades (pessoas e empresas) que integram o mesmo grupo econômico do CNPJ, com relacionamentos atuais e históricos
Influência do Quadro Societário	`SERVICE_OWNERS_INFLUENCE`	Infere o nível de influência do quadro societário, considerando exposição na mídia, envolvimento político e processos dos sócios
Distribuição de Processos dos Sócios	`SERVICE_OWNERS_LAWSUITS_DISTRIBUTION`	Consulta dados agregados sobre a distribuição de processos judiciais nos quais os sócios da empresa estão envolvidos
Processos jurídicos dos sócios	`SERVICE_JURIDICAL_PROCESSES_PJ_OWNERS`	Consulta processos associados aos sócios e agrupa indicadores por documento
KYC e compliance dos sócios	`SERVICE_COMPANY_KYC_OWNERS`	Consulta exposição a PEP, sanções atuais e históricas, e ocorrências relevantes no quadro societário
Doações eleitorais dos sócios	`SERVICE_OWNERS_ELECTORAL_DONORS_CNPJ`	Consulta doações eleitorais realizadas por sócios vinculados ao CNPJ

Exemplo rápido

Consulta de relacionamentos de uma empresa:

curl --location '{base_url}/api/service-api' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "service": "SERVICE_COMPANY_RELATIONSHIP",
    "cnpj": "cnpj"
  }'

Payload:

{
  "service": "SERVICE_COMPANY_RELATIONSHIP",
  "cnpj": "cnpj"
}

Resposta esperada:

{
  "result": {
    "cnpj": "00000000000000",
    "relationshipTotal": 1,
    "totalOwners": 1,
    "totalEmployees": 1,
    "companyRelationships": [
      {
        "cpf": "77272722314",
        "name": "NOME DO SÓCIO",
        "relationshipName": "SOCIO-ADMINISTRADOR",
        "origin": "RECEITA FEDERAL"
      }
    ]
  },
  "status": {
    "code": 200,
    "message": "Success"
  }
}

Como combinar os serviços

Uma análise PJ costuma começar com SERVICE_COMPANY_RELATIONSHIP para entender a estrutura da empresa. Em seguida, SERVICE_FIRST_LEVEL_PARTNER ajuda a resumir o entorno societário. Quando houver necessidade de aprofundar risco, use SERVICE_JURIDICAL_PROCESSES_PJ_OWNERS e SERVICE_COMPANY_KYC_OWNERS.

Próximo passo

API Reference

Contrato completo: campos, exemplos e responses de cada serviço.

Catálogo técnico de Pessoa Jurídica

Todos os services de pessoa jurídica em um único catálogo.

Escolha o serviço certo

Ainda em dúvida sobre qual service usar? Comece por aqui.

Primeiros passos

Fluxos principais

Suporte e referência

POST /api/service-api

Pessoas

Empresas

Catálogo técnico

Sócios e relacionamentos

Sócios e relacionamentos

Quando usar

Serviços disponíveis

Exemplo rápido

Como combinar os serviços

Próximo passo

API Reference

Catálogo técnico de Pessoa Jurídica

Escolha o serviço certo

​Sócios e relacionamentos

​Quando usar

​Serviços disponíveis

​Exemplo rápido

​Como combinar os serviços

​Próximo passo

API Reference

Catálogo técnico de Pessoa Jurídica

Escolha o serviço certo

Sócios e relacionamentos

Quando usar

Serviços disponíveis

Exemplo rápido

Como combinar os serviços

Próximo passo