Risco e compliance

Use estes serviços para identificar sinais de risco associados a uma pessoa física, incluindo exposição política, certidões, antecedentes, protestos, débitos, processos, mandados e scores. Eles apoiam decisões de onboarding, crédito, prevenção à fraude, compliance e monitoramento contínuo. Todos os serviços desta categoria são consumidos pelo endpoint:

POST /api/service-api

Quando usar

Use esta categoria quando precisar:

verificar se a pessoa é PEP ou possui exposição pública relevante;
consultar sanções e histórico de compliance em uma visão consolidada;
avaliar propensão de fraude ou inadimplência;
consultar certidões, antecedentes criminais e nada consta;
verificar protestos, débitos ativos e processos;
complementar uma esteira de aprovação com sinais de risco.

Serviços disponíveis

Serviço	Código `service`	Uso principal
Pessoa politicamente exposta	`SERVICE_PEP`	Indica se o CPF pertence a uma Pessoa Politicamente Exposta
KYC e compliance de pessoa física	`SERVICE_PERSON_KYC`	Consolida PEP, sanções e histórico de compliance associado ao CPF
Exposição e perfil na mídia PF	`SERVICE_MEDIA_PROFILE_EXPOSURE_PF`	Consulta exposição pública, notoriedade, impopularidade e notícias relacionadas ao CPF
Dívida ativa PF	`SERVICE_ACTIVE_DEBT_PF`	Consulta situação de dívida ativa em fontes públicas
Débitos ativos PF	`SERVICE_ACTIVE_DEBT_PF`	Retorna totais e lista de débitos ativos associados ao CPF
Score de risco de fraude	`SERVICE_FRAUD_RISK_SCORE`	Mede propensão de fraude com base em fator de risco
Risco financeiro	`SERVICE_FINANCIAL_RISK_SCORE`	Retorna score e leitura resumida de risco financeiro
Score de inadimplência	`SERVICE_DEFAULT_RISK_SCORE`	Retorna score, faixa de risco e probabilidade esperada de inadimplência
Score de Crédito	`SERVICE_QUOD_CREDIT_SCORE_PERSON`	Consulta score de crédito de pessoa física, com nível e classificação de risco
Score de Crédito Multidados	`SERVICE_BOAVISTA_ONE_SCORE_PERSON`	Consulta score de crédito multidados de pessoa física
Dados Restritivos	`SERVICE_BOAVISTA_CREDIT_SCORE_PERSON`	Consulta dados restritivos de crédito de pessoa física, com indicativo e quantidade de restrições
Flags Negativos	`SERVICE_QUOD_CREDIT_RISK_PERSON`	Consulta flags negativos de crédito de pessoa física, com nível e classificação de risco
Propensão a apostas online	`SEVICE_ONLINE_BETTING_PROPENSITY`	Avalia sinais de propensão a apostas online associados ao CPF
Nada consta em ações judiciais	`SERVICE_NOTHING_RECORD_LAWSUITS`	Emite certidão de Nada Consta em tribunais regionais federais
Antecedentes criminais federais	`SERVICE_CRIMINAL_RECORD_FEDERAL`	Consulta certidão de antecedentes criminais federal
Antecedentes criminais civis	`SERVICE_CRIMINAL_RECORD_CIVIL`	Consulta certidão de antecedentes criminais estadual
Certidão negativa de protesto	`SERVICE_PROTEST_CLEARANCE_CERTIFICATE`	Consulta protestos em cartórios e detalhes de títulos
Processos jurídicos	`SERVICE_JURIDICAL_PROCESSES`	Consulta processos jurídicos e administrativos associados ao CPF
Servidores públicos	`SERVICE_PUBLIC_SERVANTS`	Consulta vínculos com serviço público
Mandado de prisão	`SERVICE_ARREST_WARRANT`	Consulta existência de mandado de prisão

Exemplo rápido

Consulta de score de risco de fraude:

curl --location '{base_url}/api/service-api' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "service": "SERVICE_FRAUD_RISK_SCORE",
    "cpf": "cpf",
    "factor": "minRisk or minattrition"
  }'

Payload:

{
  "service": "SERVICE_FRAUD_RISK_SCORE",
  "cpf": "cpf",
  "factor": "minRisk or minattrition"
}

Resposta esperada:

{
  "result": {
    "cpf": "80246074507",
    "score": "8.0691",
    "factor": "MEDIUM RISK",
    "message": "Success calculating score"
  },
  "status": {
    "code": 200,
    "message": "Success"
  }
}

Leitura dos resultados

O objeto status indica o resultado técnico da chamada. Os sinais de negócio ficam no objeto result, como status da certidão, scores, fatores de risco, valores de dívida, protestos e indicadores encontrados. Em fluxos críticos, combine mais de uma consulta para reduzir decisão baseada em um único sinal. Para campos, exemplos completos e responses, consulte a API Reference ou o Catálogo técnico de Pessoa Física.

Primeiros passos

Suporte e referência

Fluxos principais

POST /api/service-api

Pessoas

Empresas

Catálogo técnico

Risco e compliance

Risco e compliance

Quando usar

Serviços disponíveis

Exemplo rápido

Leitura dos resultados

​Risco e compliance

​Quando usar

​Serviços disponíveis

​Exemplo rápido

​Leitura dos resultados

Risco e compliance

Quando usar

Serviços disponíveis

Exemplo rápido

Leitura dos resultados