Relacionamentos e QSA/UBO

Grupo Empresarial - Sociedade

O serviço de Grupo Empresarial - Sociedade retorna informações consolidadas sobre empresas nas quais a pessoa é ou foi sócia.

Falar com o comercial Ver o catálogo

Quando usar

Descrição

O serviço de Grupo Empresarial - Sociedade fornece uma visão consolidada de empresas relacionadas à pessoa consultada por vínculo societário.

A partir desse agrupamento, é possível analisar informações agregadas como quantidade de empresas, situação cadastral, distribuição geográfica, estimativas de faixa de renda e de funcionários, além de indicadores de risco associados ao grupo empresarial.

Esse conjunto de informações pode ser utilizado para apoiar processos de análise de risco, KYC simplificado, estimativa patrimonial e inferência de renda, sem a necessidade de consultar individualmente cada empresa relacionada.

Requisição

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

POST /api/v1/{tenant}/pessoas/grupo-empresarial-sociedade

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

{
  "document": "000.000.000-00"
}

Campos de retorno

Campos dentro de data. [] indica lista.

Campo	Tipo
`Result[].MatchKeys`	texto
`Result[].EconomicGroups[].MainCompanyTaxId`	texto
`Result[].EconomicGroups[].EconomicGroupType`	texto
`Result[].EconomicGroups[].TotalCompanies`	número
`Result[].EconomicGroups[].TotalHeadquarters`	número
`Result[].EconomicGroups[].TotalBranches`	número
`Result[].EconomicGroups[].TotalStates`	número
`Result[].EconomicGroups[].TotalCities`	número
`Result[].EconomicGroups[].TotalActiveCompanies`	número
`Result[].EconomicGroups[].TotalInactiveCompanies`	número
`Result[].EconomicGroups[].MinCompanyAge`	número
`Result[].EconomicGroups[].MaxCompanyAge`	número
`Result[].EconomicGroups[].AverageCompanyAge`	número
`Result[].EconomicGroups[].MinActivityLevel`	número
`Result[].EconomicGroups[].MaxActivityLevel`	número
`Result[].EconomicGroups[].AverageActivityLevel`	número
`Result[].EconomicGroups[].TotalIncomeRange`	texto
`Result[].EconomicGroups[].MinIncomeRange`	texto
`Result[].EconomicGroups[].MaxIncomeRange`	texto
`Result[].EconomicGroups[].AverageIncomeRange`	texto
`Result[].EconomicGroups[].TotalEmployeesRange`	texto
`Result[].EconomicGroups[].MinEmployeesRange`	texto
`Result[].EconomicGroups[].MaxEmployeesRange`	texto
`Result[].EconomicGroups[].AverageEmployeesRange`	texto
`Result[].EconomicGroups[].TotalPeople`	número
`Result[].EconomicGroups[].TotalOwners`	número
`Result[].EconomicGroups[].TotalPEPs`	número
`Result[].EconomicGroups[].TotalSanctioned`	número
`Result[].EconomicGroups[].TotalLawsuits`	número
`Result[].EconomicGroups[].TotalWebsites`	número
`Result[].EconomicGroups[].TotalAddresses`	número
`Result[].EconomicGroups[].TotalPhones`	número
`Result[].EconomicGroups[].TotalEmails`	número
`Result[].EconomicGroups[].TotalPassages`	número
`Result[].EconomicGroups[].TotalBadPassages`	número
`Result[].EconomicGroups[].MonthAveragePassages`	número
`Result[].EconomicGroups[].FirstPassageDate`	data
`Result[].EconomicGroups[].LastPassageDate`	data
`Result[].EconomicGroups[].Last3MonthsPassages`	número
`Result[].EconomicGroups[].Last6MonthsPassages`	número
`Result[].EconomicGroups[].Last12MonthsPassages`	número
`Result[].EconomicGroups[].Last18MonthsPassages`	número
`Result[].EconomicGroups[].EconomicActivities[]`	texto
`Result[].EconomicGroups[].EntitiesByLevel[]`	número
`Result[].EconomicGroups[].IncomeRangeDistribution.<chave>`	número
`Result[].EconomicGroups[].EmployeeRangeDistribution.<chave>`	número
`Result[].EconomicGroups[].StateDistribution.AC`	número
`Result[].EconomicGroups[].StateDistribution.AL`	número
`Result[].EconomicGroups[].StateDistribution.AM`	número
`Result[].EconomicGroups[].StateDistribution.AP`	número
`Result[].EconomicGroups[].StateDistribution.BA`	número
`Result[].EconomicGroups[].StateDistribution.CE`	número
`Result[].EconomicGroups[].StateDistribution.DF`	número
`Result[].EconomicGroups[].StateDistribution.ES`	número
`Result[].EconomicGroups[].StateDistribution.GO`	número
`Result[].EconomicGroups[].StateDistribution.MA`	número
`Result[].EconomicGroups[].StateDistribution.MG`	número
`Result[].EconomicGroups[].StateDistribution.MS`	número
`Result[].EconomicGroups[].StateDistribution.MT`	número
`Result[].EconomicGroups[].StateDistribution.PA`	número
`Result[].EconomicGroups[].StateDistribution.PB`	número
`Result[].EconomicGroups[].StateDistribution.PE`	número
`Result[].EconomicGroups[].StateDistribution.PI`	número
`Result[].EconomicGroups[].StateDistribution.PR`	número
`Result[].EconomicGroups[].StateDistribution.RJ`	número
`Result[].EconomicGroups[].StateDistribution.RN`	número
`Result[].EconomicGroups[].StateDistribution.RO`	número
`Result[].EconomicGroups[].StateDistribution.RR`	número
`Result[].EconomicGroups[].StateDistribution.RS`	número
`Result[].EconomicGroups[].StateDistribution.SC`	número
`Result[].EconomicGroups[].StateDistribution.SE`	número
`Result[].EconomicGroups[].StateDistribution.SP`	número
`Result[].EconomicGroups[].StateDistribution.TO`	número
`Result[].EconomicGroups[].StateDistribution.EX`	número
`Result[].EconomicGroups[].CityDistribution.CAMPINAS`	número
`Result[].EconomicGroups[].CityDistribution.<chave>`	número
`Result[].EconomicGroups[].CompanyDocNumbers[]`	texto
`Result[].EconomicGroups[].TotalValueInPartyDonationsInLastElection`	número
`Result[].EconomicGroups[].TotalValueInPartyDonationsInPenultimateElection`	número
`Result[].EconomicGroups[].TotalValueInCandidateDonationsInLastElection`	número
`Result[].EconomicGroups[].TotalValueInCandidateDonationsInPenultimateElection`	número
`Result[].EconomicGroups[].TotalDistinctPartyDonatedToInLastElection`	número
`Result[].EconomicGroups[].TotalDistinctPartyDonatedToInPenultimateElection`	número
`Result[].EconomicGroups[].TotalDistinctCandidateDonatedToInLastElection`	número
`Result[].EconomicGroups[].TotalDistinctCandidateDonatedToInPenultimateElection`	número
`Result[].EconomicGroups[].TotalCompaniesWithElectoralDonationInLastElection`	número
`Result[].EconomicGroups[].TotalCompaniesWithElectoralDonationInPenultimateElection`	número

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": "Grupo Empresarial - Sociedade",
  "query_slug": "grupo-empresarial-sociedade",
  "data": {
    "Result": [
      {
        "MatchKeys": "texto",
        "EconomicGroups": [
          {
            "MainCompanyTaxId": "texto",
            "EconomicGroupType": "texto",
            "TotalCompanies": 0,
            "TotalHeadquarters": 0,
            "TotalBranches": 0,
            "TotalStates": 0,
            "TotalCities": 0,
            "TotalActiveCompanies": 0,
            "TotalInactiveCompanies": 0,
            "MinCompanyAge": 0,
            "MaxCompanyAge": 0,
            "AverageCompanyAge": 0,
            "MinActivityLevel": 0,
            "MaxActivityLevel": 0,
            "AverageActivityLevel": 0,
            "TotalIncomeRange": "texto",
            "MinIncomeRange": "texto",
            "MaxIncomeRange": "texto",
            "AverageIncomeRange": "texto",
            "TotalEmployeesRange": "texto",
            "MinEmployeesRange": "texto",
            "MaxEmployeesRange": "texto",
            "AverageEmployeesRange": "texto",
            "TotalPeople": 0,
            "TotalOwners": 0,
            "TotalPEPs": 0,
            "TotalSanctioned": 0,
            "TotalLawsuits": 0,
            "TotalWebsites": 0,
            "TotalAddresses": 0,
            "TotalPhones": 0,
            "TotalEmails": 0,
            "TotalPassages": 0,
            "TotalBadPassages": 0,
            "MonthAveragePassages": 0,
            "FirstPassageDate": "2026-01-01",
            "LastPassageDate": "2026-01-01",
            "Last3MonthsPassages": 0,
            "Last6MonthsPassages": 0,
            "Last12MonthsPassages": 0,
            "Last18MonthsPassages": 0,
            "EconomicActivities": [
              "texto"
            ],
            "EntitiesByLevel": [
              0
            ],
            "IncomeRangeDistribution": {
              "<chave>": 0
            },
            "EmployeeRangeDistribution": {
              "<chave>": 0
            },
            "StateDistribution": {
              "AC": 0,
              "AL": 0,
              "AM": 0,
              "AP": 0,
              "BA": 0,
              "CE": 0,
              "DF": 0,
              "ES": 0,
              "GO": 0,
              "MA": 0,
              "MG": 0,
              "MS": 0,
              "MT": 0,
              "PA": 0,
              "PB": 0,
              "PE": 0,
              "PI": 0,
              "PR": 0,
              "RJ": 0,
              "RN": 0,
              "RO": 0,
              "RR": 0,
              "RS": 0,
              "SC": 0,
              "SE": 0,
              "SP": 0,
              "TO": 0,
              "EX": 0
            },
            "CityDistribution": {
              "CAMPINAS": 0,
              "<chave>": 0
            },
            "CompanyDocNumbers": [
              "texto"
            ],
            "PartyDonationDistribution": {
            },
            "CandidateDonationDistribution": {
            },
            "TotalValueInPartyDonationsInLastElection": 0,
            "TotalValueInPartyDonationsInPenultimateElection": 0,
            "TotalValueInCandidateDonationsInLastElection": 0,
            "TotalValueInCandidateDonationsInPenultimateElection": 0,
            "TotalDistinctPartyDonatedToInLastElection": 0,
            "TotalDistinctPartyDonatedToInPenultimateElection": 0,
            "TotalDistinctCandidateDonatedToInLastElection": 0,
            "TotalDistinctCandidateDonatedToInPenultimateElection": 0,
            "TotalCompaniesWithElectoralDonationInLastElection": 0,
            "TotalCompaniesWithElectoralDonationInPenultimateElection": 0
          }
        ]
      }
    ]
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.112"
}

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