> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.omni-ward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pessoa politicamente exposta

> SERVICE_PEP · Diz se o CPF é de pessoa politicamente exposta hoje e traz o histórico de cargos.

> [!NOTE]
>
> Alias: `SERVICE_PEP` · Preço: **R\$ 0,60** por consulta · Exige `purpose`

Diz se o CPF é de pessoa politicamente exposta hoje e traz o histórico de cargos.

Execute pelo endpoint único [`POST /v1/services`](https://api-docs.omni-ward.com/api-reference/executar-servicos). Você pode combinar este serviço com outros na mesma chamada, enviando cada identificador uma vez.

## Campos do request

| Campo | Obrigatório | Descrição |
| - | - | - |
| `services` | sim | Inclua `"SERVICE_PEP"` na lista. |
| `cpf` | sim | CPF, com ou sem pontuação. |
| `purpose` | sim | Finalidade do tratamento. Este serviço trata dados pessoais. |

## Campos em `result`

| Campo | Descrição | Tipo |
| - | - | - |
| `KycData` | Objeto principal de retorno do dataset, contendo as informações consolidadas relacionadas à pessoa consultada. | object |
| `KycData.PEPHistory` | Lista de objetos com o histórico de exposição política (PEP). | array |
| `KycData.PEPHistory[].Level` | Nível de relacionamento com o PEP. | string |
| `KycData.PEPHistory[].JobTitle` | Cargo exercido pelo PEP. | string |
| `KycData.PEPHistory[].Department` | Departamento de atuação do PEP. | string |
| `KycData.PEPHistory[].Motive` | Motivo pelo qual o indivíduo é considerado PEP. | string |
| `KycData.PEPHistory[].Source` | Fonte do registro. | string |
| `KycData.PEPHistory[].TaxId` | Número do documento de identificação do PEP. | string |
| `KycData.PEPHistory[].StartDate` | Data que a pessoa passou a ser PEP. | string |
| `KycData.PEPHistory[].EndDate` | Data que a pessoa deixou de ser PEP. | string |
| `KycData.PEPHistory[].CreationDate` | Data de criação deste registro. | string |
| `KycData.PEPHistory[].LastUpdateDate` | Data de ultima atualização deste registro. | string |
| `KycData.IsCurrentlyPEP` | Indica se a pessoa é classificada como PEP no momento da consulta. | boolean |
| `KycData.SanctionsHistory` | Lista de objetos com o histórico de sanções e restrições. | array |
| `KycData.SanctionsHistory[].Source` | Fonte de origem do registro de sanção. | string |
| `KycData.SanctionsHistory[].Type` | Tipo de sanção. | string |
| `KycData.SanctionsHistory[].StandardizedSanctionType` | Tipo de sanção normalizado conforme classificação interna da plataforma. | string |
| `KycData.SanctionsHistory[].MatchRate` | Índice que representa o grau de similaridade entre o nome consultado e o nome presente no registro de sanção, variando de 0 a 100. | number |
| `KycData.SanctionsHistory[].NameUniquenessScore` | Pontuação que indica o nível de unicidade do nome completo da pessoa, variando de 0 (nome extremamente comum) a 1 (nome altamente único). | number |
| `KycData.SanctionsHistory[].Details` | Informações adicionais sobre o registro de sanção. | object |
| `KycData.SanctionsHistory[].NormalizedDetails` | Detalhes normalizados adicionais sobre a sanção. | object |
| `KycData.SanctionsHistory[].NormalizedDetails.Description` | Descrição da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.OriginalName` | Nome original na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.SanctionName` | Nome da Sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.SanctionAliasesAndMatchRate` | Pseudônimo da Sanção e Taxa de Compatibilidade. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Nationalities` | Nacionalidades incluídas na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AgreementNumber` | Número do acordo encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.GrantingBody` | Entidade concedente encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ImpedimentReason` | Motivo do impedimento encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.NameInformedBySanctioningBody` | Nome Informado Pelo Órgão Sancionador encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ProcessNumber` | Número do processo encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.SanctioningBody` | Nome do órgão sancionador. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.SanctioningBodyState` | Estado do órgão sancionador. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.InformationOrigin` | Origem da informação da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PublicationDate` | Data de publicação da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedPublicationDate` | Data de publicação padronizada da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Publication` | Publicação da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.LegalSubstantiation` | Fundamentação legal da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.LegalSubstantiationDescription` | Descrição da fundamentação legal da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.OrganComplement` | Complemento do órgão da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ScopeDefinedInJudicialDecision` | Escopo definido judicialmente da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ActionYear` | Ano da ação. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Employer` | Nome do empregador. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Establishment` | Nome do Estabelecimento. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.State` | Estado da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AmountOfWorkersInvolved` | Quantidade de trabalhadores envolvidos na ação. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.CNAE` | Classificação Nacional de Atividades Econômicas (CNAE). | string |
| `KycData.SanctionsHistory[].NormalizedDetails.IrrecorribilityDate` | Data de irrecorribilidade da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedIrrecorribilityDate` | Data de irrecorribilidade padronizada da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.QueryDate` | Data da consulta da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedQueryDate` | Data padronizada da consulta da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.SanctioningBodyStateCode` | Código estatal do órgão sancionador. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.InformationOriginDate` | Data da Origem da Informação. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedInformationOriginDate` | Data padronizada da origem da informação. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.TransitDueDate` | Data de vencimento do trânsito da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedTransitDueDate` | Data padronizada de vencimento do trânsito da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.FineAmount` | Valor da multa encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ResjusdicataDate` | Data da coisa julgada da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedResjusdicataDate` | Data padronizada da coisa julgada da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.NameInSanctionList` | Nome na lista de sanções. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.NameInOriginalScript` | Nome encontrado no texto original da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PermanentReferenceNumber` | Número de referência permanente. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.OtherInformation` | Outras informações da sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.TadNumber` | Número TAD encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.InfringementNoticeNumber` | Número de auto-infração encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.DeforestedAreaHa` | Área desmatada encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PropertyLocation` | Localização da propriedade encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PropertyUF` | Unidade federativa da propriedade encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PropertyCounty` | Condado da propriedade encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Infraction` | Infração encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.RegistrationDate` | Data de registro encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedRegistrationDate` | Data de registro padronizada encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.JudgementDate` | Data de julgamento encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedJudgementDate` | Data de julgamento padronizada encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.BDCBusinessFactor` | Fator de Negócios da o provedor. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.DataSource` | Fonte da data encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.IrregularAction` | Ação irregular encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.DeliberationContent` | Conteúdo da deliberação encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ReferenceDate` | Data de referência encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedReferenceDate` | Data de referência padronizada encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.DecisionType` | Tipo de decisão encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.TimeToBeServed` | Tempo a ser servido encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.JudgementDescription` | Descrição do julgamento encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.CompleteDecisionURL` | URL da decisão completa encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PenaltyUntilEffectiveDate` | Penalidade até o dia de efetividade encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedPenaltyUntilEffectiveDate` | Penalidade padronizada até o dia de efetividade encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ProcessInfoUrl` | URL das Informações do Processo. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ApprovalDate` | Data de aprovação encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedApprovalDate` | Data de aprovação padronizada encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.SignatureDate` | Data de assinatura encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedSignatureDate` | Data padronizada de assinatura encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ArchivingDate` | Data de arquivamento encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedArchivingDate` | Data de arquivamento encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.RejectionDate` | Data de rejeição encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedRejectionDate` | Data padronizada de rejeição encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Observation` | Observação encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Process` | Número do processo encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.JudgingBody` | Órgão julgador encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Convicted` | Condenado encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ConvictionType` | Tipo de condenação encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Responsible` | Responsável encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.RGNumber` | Número do RG encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Grantor` | Concedente encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Recipient` | Beneficiário encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.JudgementType` | Tipo de julgamento encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Situation` | Situação encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.WasSentenced` | Flag indicando se foi sentenciado encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.IsPublicCompany` | Flag indicando se foi sentenciado encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.IsIneligible` | Flag indicando se é inelegível encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.RelatedSubjects` | Assuntos relacionados encontrados na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.DecisionDate` | Data de decisão encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedDecisionDate` | Data padronizada de decisão encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.IsPoliticalRightsSuspended` | Flag encontrada na sanção indicando se existe suspensão dos direitos políticos. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PoliticalRightsSuspensionStart` | Data de início da suspensão dos direitos políticos encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PoliticalRightsSuspensionEnd` | Data de início da suspensão dos direitos políticos encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.JudgmentDate` | Data de julgamento encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedJudgmentDate` | Data de julgamento padronizada encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Deliberation` | Deliberação encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AgreedValue` | Valor acordado encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PaidValue` | Valor pago encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Year` | Ano encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Effects` | Efeitos encontrados na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Status` | Status encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PADNumber` | Número PAD encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AccusedType` | Tipo acusado encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Origin` | Origem encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AppliedPenalty` | Penalidade aplicada encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Article` | Artigo encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Index` | Índice encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PenaltyValue` | Valor da penalidade encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PenaltyCurrency` | Moeda da penalidade encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.InfractionStartDate` | Data de ínicio da infração encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedInfractionStartDate` | Data padronizada de ínicio da infração encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.InfractionEndDate` | Data do fim da infração encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedInfractionEndDate` | Data padronizada do fim da infração encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.TermOfCommitmentProposal` | Termo de compromisso proposto encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.TermOfCommitmentValue` | Valoe do termo de compromisso encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.SupervisionCouncilDecision` | Valor do termo de compromisso encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Scope` | Escopo encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.HinderingReason` | Motivo do impedimento encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.LegalFramework` | Quadro jurídico encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Bidding` | Licitação encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.BirthDate` | Data de nascimento encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedBirthDate` | Data padronizada de nascimento encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.SourcePossibleDateOfBirthScore` | Score da fonte de possível data de nascimento. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AdministrativelyLinkedOrgan` | Órgão vinculado administrativamente. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AdministrativelyLinkedStateCode` | Código estatal vinculado administrativamente. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.EffectivePosition` | Posição efetiva encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PositionOrFunctionOfTrust` | Posição ou Cargo de Confiança encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Activity` | Atividade encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PunishmentOrderNumber` | Número da ordem de punição encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PunishmentOrderPublicationDate` | Data de publicação da ordem de punição encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedPunishmentOrderPublicationDate` | Data padronizada de publicação da ordem de punição encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Page` | Página. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.DOUSection` | Seção do diário oficial da união. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AdministrativeProcessNumber` | Número do processo administrativo encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.LegalBasis` | Base legal encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Designation` | Designação encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Nationality` | Nacionalidade encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Title` | Título encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.NationalIdentificationNumber` | Número de identificação nacional encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ArrestWarrantNumber` | Número do mandado de prisão encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Decision` | Decisão encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.WarrantDescription` | Descrição do Mandado encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ImprisonmentKind` | Tipo de imprisionamento encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Magistrate` | Magistrado encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Agency` | Agência encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.County` | Condado encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Recapture` | Recaptura encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PenaltyTime` | Tempo de penalidade encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PrisonRegime` | Regime de prisão encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.IsPublicAgent` | Flag indicando se é agente público. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Function` | Função encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Penalty` | Penalidade encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.PenaltyTimeToBeServed` | Tempo de penalidade a ser cumprido encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.FinalDeadline` | Prazo final encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedFinalDeadlineDate` | Data padronizada do prazo final encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Subject` | Assunto encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.InstitutionInCharge` | Instituição no comando encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.CurrentPhase` | Fase atual encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.CurrentSubPhase` | Sub-fase atual encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.LastChangePhaseDate` | Data da última mudança de fase encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedLastChangePhaseDate` | Data padronizada da última mudança de fase encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.LastChangePlaceDate` | Data da última mudança de lugar encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.StandardizedLastChangePlaceDate` | Data padronizada da última mudança de lugar encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.AmnestyName` | Nome da anistia encontrada na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.Value` | Valor encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.DecreeNumber` | Número do decreto encontrado na sanção. | string |
| `KycData.SanctionsHistory[].NormalizedDetails.ReferenceMonth` | Mês de referência encontrado na sanção. | string |
| `KycData.SanctionsHistory[].StartDate` | Data de início da sanção. | string |
| `KycData.SanctionsHistory[].EndDate` | Data de término da sanção. | string |
| `KycData.SanctionsHistory[].CreationDate` | Data de criação do registro da sanção. | string |
| `KycData.SanctionsHistory[].LastUpdateDate` | Data de ultima atualização para esse registro. | string |
| `KycData.SanctionsHistory[].IsCurrentlyPresentOnSource` | Flag marcando se a sanção se encontra presente na fonte desde a última atualização | boolean |
| `KycData.SanctionsHistory[].WasRecentlyPresentOnSource` | Flag marcando se verificamos que a sanção esteve recentemente presente na fonte de acordo com a última atualização | boolean |
| `KycData.IsCurrentlySanctioned` | Indica se a pessoa está atualmente sob alguma sanção. | boolean |
| `KycData.WasPreviouslySanctioned` | Indica se existiu sanções anteriormente | boolean |
| `KycData.Last30DaysSanctions` | Quantidade de sanções e restrições encontradas nos últimos 30 dias. | integer |
| `KycData.Last90DaysSanctions` | Quantidade de sanções e restrições encontradas nos últimos 90 dias. | integer |
| `KycData.Last180DaysSanctions` | Quantidade de sanções e restrições encontradas nos últimos 180 dias. | integer |
| `KycData.Last365DaysSanctions` | Quantidade de sanções e restrições encontradas nos últimos 365 dias. | integer |
| `KycData.LastYearPEPOccurence` | Quantidade de registros de PEP encontrados no último ano. | integer |
| `KycData.Last3YearsPEPOccurence` | Quantidade de registros de PEP encontrados nos últimos 3 anos. | integer |
| `KycData.Last5YearsPEPOccurence` | Quantidade de registros de PEP encontrados nos últimos 5 anos. | integer |
| `KycData.Last5PlusYearsPEPOccurence` | Quantidade de registros de PEP encontrados nos últimos 5 anos ou mais. | integer |
| `KycData.FirstPEPOccurenceDate` | Data do primeiro registro de PEP encontrado para o indivíduo. | string |
| `KycData.LastPEPOccurenceDate` | Data do último registro de PEP encontrado para o indivíduo. | string |
| `KycData.FirstSanctionDate` | Data do primeiro registro de sanções encontrado para o indivíduo. | string |
| `KycData.LastSanctionDate` | Data do último registro de sanções encontrado para o indivíduo. | string |
| `KycData.IsCurrentlyElectoralDonor` | Indica se a entidade doou para partidos/candidatos nas duas últimas 2 eleições. | boolean |
| `KycData.IsHistoricalElectoralDonor` | Indica se a entidade tem histórico de doação para partidos/candidatos. | boolean |
| `KycData.TotalElectoralDonations` | Total de doações para partidos/candidatos. | integer |
| `KycData.TotalElectoralDonationAmount` | Valor total das doações para partidos/candidatos. | number |
| `KycData.ElectoralDonations` | Registro das doações para partidos/candidatos por ano de eleição. | object |

Todo `result` traz também `outcome`, o resumo da consulta: `clear`, `alert`, `match`, `no_match` ou `not_found`.

```bash cURL theme={null}
curl --request POST 'https://api.omni-ward.com/v1/services' \
  --header 'Authorization: Bearer $OMNI_WARD_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: $(uuidgen)' \
  --data '{
  "services": [
    "SERVICE_PEP"
  ],
  "cpf": "00000000000",
  "purpose": "Abertura de conta"
}'
```

```javascript Node.js theme={null}
const res = await fetch('https://api.omni-ward.com/v1/services', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.OMNI_WARD_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "services": [
      "SERVICE_PEP"
    ],
    "cpf": "00000000000",
    "purpose": "Abertura de conta"
  }),
});
const { results } = await res.json();
```

```python Python theme={null}
import os, uuid, requests

res = requests.post(
    "https://api.omni-ward.com/v1/services",
    headers={"Authorization": f"Bearer {os.environ['OMNI_WARD_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={
      "services": [
        "SERVICE_PEP"
      ],
      "cpf": "00000000000",
      "purpose": "Abertura de conta"
    },
    timeout=90,
)
results = res.json()["results"]
```

```php PHP theme={null}
$ch = curl_init("https://api.omni-ward.com/v1/services");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("OMNI_WARD_API_KEY"),
    "Content-Type: application/json",
    "Idempotency-Key: " . bin2hex(random_bytes(16)),
  ],
  CURLOPT_POSTFIELDS => '{"services":["SERVICE_PEP"],"cpf":"00000000000","purpose":"Abertura de conta"}',
]);
$results = json_decode(curl_exec($ch), true)["results"];
```

```java Java theme={null}
var body = """
    {
      "services": [
        "SERVICE_PEP"
      ],
      "cpf": "00000000000",
      "purpose": "Abertura de conta"
    }
    """;
var request = HttpRequest.newBuilder(URI.create("https://api.omni-ward.com/v1/services"))
    .header("Authorization", "Bearer " + System.getenv("OMNI_WARD_API_KEY"))
    .header("Content-Type", "application/json")
    .header("Idempotency-Key", UUID.randomUUID().toString())
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
```

```json 200 theme={null}
{
  "results": [
    {
      "service": "SERVICE_PEP",
      "status": {
        "code": 200,
        "message": "Success"
      },
      "result": {
        "KycData": {
          "PEPHistory": [
            {
              "Level": "1",
              "JobTitle": "PRESIDENTE DA REPUBLICA",
              "Department": "PRESIDENCIA DA REPUBLICA",
              "Motive": "FEDERAL EMPLOYEE",
              "Source": "PEP_PORTAL",
              "TaxId": "453*****791",
              "StartDate": "2019-01-01T00:00:00Z",
              "EndDate": "2028-01-01T00:00:00Z"
            }
          ],
          "IsCurrentlyPEP": true,
          "SanctionsHistory": [
            {
              "Source": "interpol",
              "Type": "Law Enforcement",
              "StandardizedSanctionType": "ARREST WARRANTS",
              "MatchRate": 48,
              "NameUniquenessScore": 1,
              "Details": {
                "OriginalName": "JAI****************ARO",
                "SanctionName": "JAI************LHO",
                "BirthDate": "1976/10/13",
                "StandardizedBirthDate": "1976-10-13T00:00:00",
                "SourcePossibleDateOfBirthScore": "0",
                "Nationalities": "BRAZIL",
                "image": "https://ws-public.interpol.int/notices/v1/red/2024-20392/images/63032120",
                "charges": "1) arrestation, enlèvement, séquestration ou détention arbitraire suivi d'une libération avant le 7e jour 2) 3) 4) 6) vol par ruse, effraction ou escalade dans un local d'habitation ou un lieu d'entrepôt, aggravé par une autre circonstance 5) tentative de vol par ruse, effraction ou escalade dans un local d'habitation ou un lieu d'entrepôt, aggravé par une autre circonstance 7) participation à une association de malfaiteurs en vue de la préparation d'un délit puni de 10 ans d'emprisonnement"
              },
              "NormalizedDetails": {
                "OriginalName": "JAI****************ARO",
                "SanctionName": "JAI************LHO",
                "Nationalities": "BRAZIL",
                "BirthDate": "1976/10/13",
                "StandardizedBirthDate": "1976-10-13T00:00:00",
                "SourcePossibleDateOfBirthScore": "0"
              },
              "StartDate": "0001-01-01T00:00:00",
              "EndDate": "9999-12-31T23:59:59.9999999",
              "CreationDate": "2025-08-13T03:06:03.312",
              "LastUpdateDate": "2025-08-13T03:06:03.312",
              "IsCurrentlyPresentOnSource": false,
              "WasRecentlyPresentOnSource": true
            }
          ],
          "IsCurrentlySanctioned": false,
          "WasPreviouslySanctioned": false,
          "Last30DaysSanctions": 0,
          "Last90DaysSanctions": 0,
          "Last180DaysSanctions": 0,
          "Last365DaysSanctions": 0,
          "LastYearPEPOccurence": 2,
          "Last3YearsPEPOccurence": 1,
          "Last5YearsPEPOccurence": 0,
          "Last5PlusYearsPEPOccurence": 2,
          "FirstPEPOccurenceDate": "1999-01-01T00:00:00Z",
          "LastPEPOccurenceDate": "2019-01-01T00:00:00Z",
          "FirstSanctionDate": "0001-01-01T00:00:00",
          "LastSanctionDate": "0001-01-01T00:00:00",
          "IsCurrentlyElectoralDonor": true,
          "IsHistoricalElectoralDonor": true,
          "TotalElectoralDonations": 20000,
          "TotalElectoralDonationAmount": "8207305,5",
          "ElectoralDonations": {
            "2002": {
              "DonationsCount": 10,
              "AmountDonated": "14584,71"
            },
            "2004": {
              "DonationsCount": 1,
              "AmountDonated": 10000
            },
            "2006": {
              "DonationsCount": 1,
              "AmountDonated": 10000
            },
            "2008": {
              "DonationsCount": 1,
              "AmountDonated": 15000
            },
            "2012": {
              "DonationsCount": 1,
              "AmountDonated": 12000
            },
            "2014": {
              "DonationsCount": 3,
              "AmountDonated": 18500
            },
            "2016": {
              "DonationsCount": 5,
              "AmountDonated": 23500
            },
            "2018": {
              "DonationsCount": 93,
              "AmountDonated": "1622774,9"
            },
            "2020": {
              "DonationsCount": 2,
              "AmountDonated": 11000
            },
            "2022": {
              "DonationsCount": 19882,
              "AmountDonated": 6468946
            },
            "2024": {
              "DonationsCount": 1,
              "AmountDonated": 1000
            }
          }
        },
        "outcome": "clear"
      },
      "simulated": false,
      "costMinor": 60
    }
  ],
  "totalCostMinor": 60
}
```

```json 422 theme={null}
{
  "error": {
    "code": "validation_failed",
    "message": "Alguns serviços não podem ser executados. Nada foi consultado nem cobrado.",
    "correlationId": "4f1c9a7e-2b1d-4c55-9a51-0d2f6f1c2a10",
    "details": {
      "results": [
        {
          "service": "SERVICE_PEP",
          "status": {
            "code": 422,
            "message": "Validation failed"
          },
          "result": null,
          "errors": [
            {
              "field": "cpf",
              "code": "required",
              "message": "Informe CPF: este serviço exige o campo."
            }
          ]
        }
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.