Relacionamentos e QSA/UBO

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.

Falar com o comercial Ver o catálogo

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.

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/kyc-e-compliance-dos-socios

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
`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

Estrutura real da resposta, com valores fictícios.

{
  "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"
}

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