# KYC e Compliance dos Sócios

O serviço de Informações de KYC e Compliance dos Sócios oferece dados semelhantes ao KYC tradicional, mas focado nos registros dos sócios de uma empresa. Simplifica a verificação e análise, evitando a necessidade de consultas individuais para cada sócio, e pode trazer vantagens financeiras dependendo do número de sócios.

- **Identificador:** `empresas/kyc-e-compliance-dos-socios`
- **Categoria:** Relacionamentos e QSA/UBO
- **Audiência:** PJ
- **Endpoint:** `POST /api/v1/{tenant}/empresas/kyc-e-compliance-dos-socios`
- **Preço de tabela:** R$ 0,180 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/empresas/kyc-e-compliance-dos-socios

## Quando usar

Descrição

O serviço de KYC e Compliance dos Sócios retorna informações de verificação e conformidade relacionadas aos sócios da empresa consultada, com foco nos registros específicos de cada sócio identificado no quadro societário.

O objetivo é facilitar os processos de análise e verificação, permitindo a consulta das informações relevantes dos sócios em uma única requisição, sem a necessidade de realizar consultas individuais para cada um.

Dependendo da quantidade de sócios, essa consulta pode proporcionar maior eficiência operacional em relação à verificação individual.

## Parâmetros (corpo JSON)

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

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `OwnersKycData[].PEPHistory[].Level` | texto |
| `OwnersKycData[].PEPHistory[].JobTitle` | texto |
| `OwnersKycData[].PEPHistory[].Department` | texto |
| `OwnersKycData[].PEPHistory[].Motive` | texto |
| `OwnersKycData[].PEPHistory[].Source` | texto |
| `OwnersKycData[].PEPHistory[].TaxId` | texto |
| `OwnersKycData[].PEPHistory[].StartDate` | data |
| `OwnersKycData[].PEPHistory[].EndDate` | data |
| `OwnersKycData[].IsCurrentlyPEP` | booleano |
| `OwnersKycData[].SanctionsHistory[].Source` | texto |
| `OwnersKycData[].SanctionsHistory[].Type` | texto |
| `OwnersKycData[].SanctionsHistory[].StandardizedSanctionType` | texto |
| `OwnersKycData[].SanctionsHistory[].MatchRate` | número |
| `OwnersKycData[].SanctionsHistory[].NameUniquenessScore` | número |
| `OwnersKycData[].SanctionsHistory[].Details.OriginalName` | texto |
| `OwnersKycData[].SanctionsHistory[].Details.SanctionName` | texto |
| `OwnersKycData[].SanctionsHistory[].Details.BirthDate` | texto |
| `OwnersKycData[].SanctionsHistory[].Details.StandardizedBirthDate` | data |
| `OwnersKycData[].SanctionsHistory[].Details.SourcePossibleDateOfBirthScore` | texto |
| `OwnersKycData[].SanctionsHistory[].Details.remarks` | texto |
| `OwnersKycData[].SanctionsHistory[].NormalizedDetails.OriginalName` | texto |
| `OwnersKycData[].SanctionsHistory[].NormalizedDetails.SanctionName` | texto |
| `OwnersKycData[].SanctionsHistory[].NormalizedDetails.BirthDate` | texto |
| `OwnersKycData[].SanctionsHistory[].NormalizedDetails.StandardizedBirthDate` | data |
| `OwnersKycData[].SanctionsHistory[].NormalizedDetails.SourcePossibleDateOfBirthScore` | texto |
| `OwnersKycData[].SanctionsHistory[].StartDate` | data |
| `OwnersKycData[].SanctionsHistory[].EndDate` | data |
| `OwnersKycData[].SanctionsHistory[].CreationDate` | data |
| `OwnersKycData[].SanctionsHistory[].LastUpdateDate` | data |
| `OwnersKycData[].SanctionsHistory[].IsCurrentlyPresentOnSource` | booleano |
| `OwnersKycData[].SanctionsHistory[].WasRecentlyPresentOnSource` | booleano |
| `OwnersKycData[].IsCurrentlySanctioned` | booleano |
| `OwnersKycData[].WasPreviouslySanctioned` | booleano |
| `OwnersKycData[].Last30DaysSanctions` | número |
| `OwnersKycData[].Last90DaysSanctions` | número |
| `OwnersKycData[].Last180DaysSanctions` | número |
| `OwnersKycData[].Last365DaysSanctions` | número |
| `OwnersKycData[].LastYearPEPOccurence` | número |
| `OwnersKycData[].Last3YearsPEPOccurence` | número |
| `OwnersKycData[].Last5YearsPEPOccurence` | número |
| `OwnersKycData[].Last5PlusYearsPEPOccurence` | número |
| `OwnersKycData[].FirstPEPOccurenceDate` | data |
| `OwnersKycData[].LastPEPOccurenceDate` | data |
| `OwnersKycData[].IsCurrentlyElectoralDonor` | booleano |
| `OwnersKycData[].IsHistoricalElectoralDonor` | booleano |
| `OwnersKycData[].TotalElectoralDonations` | número |
| `OwnersKycData[].TotalElectoralDonationAmount` | número |
| `OwnersKycData[].ElectoralDonations[].DonationsCount` | número |
| `OwnersKycData[].ElectoralDonations[].AmountDonated` | número |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "KYC e Compliance dos Sócios",
  "query_slug": "kyc-e-compliance-dos-socios",
  "data": {
    "CompanyOwnersKycData": {
    },
    "OwnersKycData": [
      {
        "PEPHistory": [
          {
            "Level": "texto",
            "JobTitle": "texto",
            "Department": "texto",
            "Motive": "texto",
            "Source": "texto",
            "TaxId": "texto",
            "StartDate": "2026-01-01",
            "EndDate": "2026-01-01"
          }
        ],
        "IsCurrentlyPEP": false,
        "SanctionsHistory": [
          {
            "Source": "texto",
            "Type": "texto",
            "StandardizedSanctionType": "texto",
            "MatchRate": 0,
            "NameUniquenessScore": 0,
            "Details": {
              "OriginalName": "texto",
              "SanctionName": "texto",
              "BirthDate": "texto",
              "StandardizedBirthDate": "2026-01-01",
              "SourcePossibleDateOfBirthScore": "texto",
              "remarks": "texto"
            },
            "NormalizedDetails": {
              "OriginalName": "texto",
              "SanctionName": "texto",
              "BirthDate": "texto",
              "StandardizedBirthDate": "2026-01-01",
              "SourcePossibleDateOfBirthScore": "texto"
            },
            "StartDate": "2026-01-01",
            "EndDate": "2026-01-01",
            "CreationDate": "2026-01-01",
            "LastUpdateDate": "2026-01-01",
            "IsCurrentlyPresentOnSource": false,
            "WasRecentlyPresentOnSource": false
          }
        ],
        "IsCurrentlySanctioned": false,
        "WasPreviouslySanctioned": false,
        "Last30DaysSanctions": 0,
        "Last90DaysSanctions": 0,
        "Last180DaysSanctions": 0,
        "Last365DaysSanctions": 0,
        "LastYearPEPOccurence": 0,
        "Last3YearsPEPOccurence": 0,
        "Last5YearsPEPOccurence": 0,
        "Last5PlusYearsPEPOccurence": 0,
        "FirstPEPOccurenceDate": "2026-01-01",
        "LastPEPOccurenceDate": "2026-01-01",
        "IsCurrentlyElectoralDonor": false,
        "IsHistoricalElectoralDonor": false,
        "TotalElectoralDonations": 0,
        "TotalElectoralDonationAmount": 0,
        "ElectoralDonations": [
          {
            "DonationsCount": 0,
            "AmountDonated": 0
          }
        ]
      }
    ]
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.180"
}
```