💡 A API PEP Estendida - Pessoa Exposta Politicamente + Parentescos permite verificar se determinado CPF pertence a uma Pessoa Exposta Politicamente (PEP) e identificar os vínculos de parentesco relacionados. Ideal para compliance e due diligence, ajuda a garantir conformidade com as regulamentações do Conselho de Controle de Atividades Financeiras (Coaf).


Introdução

A API PEP Estendida - Pessoa Exposta Politicamente + Parentescos identifica agentes públicos em posições relevantes, incluindo seus familiares e associados. A consulta oferece informações detalhadas sobre vínculos de parentesco, auxiliando na análise de risco e na prevenção de lavagem de dinheiro.


URL Base

A API está hospedada no seguinte endereço:

https://api.directd.com.br

Endpoint

Consulta PEP Estendida - Pessoa Exposta Politicamente + Parentescos

GET /api/PEPParentescos

Descrição: Endpoint para verificar se o CPF pertence a uma Pessoa Exposta Politicamente e listar seus parentes.

Nota: Esta consulta não gera comprovantes.


Autenticação

Para acessar esta API, é necessário fornecer um token de autenticação.

Regras de Autenticação:

  1. O token deve ser enviado como parâmetro na URL da requisição.
  2. O token é obrigatório para realizar consultas.

Campos da API

Dados Gerais

  • CPF: Número do CPF consultado.
  • Nome: Nome da pessoa associada ao CPF.
  • Flag isPEP: Indica se a pessoa é PEP (true ou false).
  • Função: Cargo ou função pública desempenhada.
  • Órgão: Instituição ou órgão associado à função pública.
  • Data da Consulta: Data em que a consulta foi realizada.
  • Status: Estado atual da consulta (ex.: ativo, inativo).

Parentescos

  • Grau de Parentesco: Relação com a Pessoa Exposta Politicamente.
  • CPF: CPF do parente.
  • Nome: Nome do parente.
  • Data de Nascimento: Data de nascimento do parente.
  • Gênero: Gênero do parente.
  • Flag Óbito: Indica se o parente está falecido (true ou false).
  • Data de Óbito: Data do falecimento (se aplicável).

Parâmetros

NomeTipoObrigatórioDescrição
CPFstringSimCPF da pessoa a ser consultada.
TOKENstringSimToken de autenticação necessário para a consulta.

Exemplos de Requisição

Usando cURL

curl 'https://api.directd.com.br/api/PEPParentescos?CPF=12345678909&TOKEN=seu_token_aqui'

Respostas

Sucesso (200)

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "PEP Estendida - Pessoa Exposta Politicamente + Parentescos",
    "consultaUid": "pep-extended-123456",
    "usuario": "João Silva",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 200
  },
  "retorno": {
    "cpf": "123.456.789-09",
    "nome": "JOÃO DA SILVA",
    "isPEP": true,
    "funcao": "Deputado Federal",
    "orgao": "Câmara dos Deputados",
    "parentescos": [
      {
        "grauParentesco": "Filho",
        "cpf": "987.654.321-00",
        "nome": "MARIA DA SILVA",
        "dataNascimento": "1995-03-10",
        "genero": "Feminino",
        "isObito": false,
        "dataObito": null},
      {
        "grauParentesco": "Cônjuge",
        "cpf": "112.233.445-56",
        "nome": "ANA DA SILVA",
        "dataNascimento": "1980-07-15",
        "genero": "Feminino",
        "isObito": false,
        "dataObito": null}
    ],
    "dataConsulta": "2024-12-09",
    "status": "Ativo"
  }
}

9. Erros Comuns

CódigoDescrição
400Requisição inválida: parâmetros incorretos.
401Não autenticado: token inválido ou ausente.
403Não autorizado: saldo insuficiente para realizar a consulta.
404Não encontrado: registro não localizado.
408Tempo esgotado: consulta não foi concluída no prazo.
500Erro interno: falha no processamento da consulta.
503Serviço em manutenção: indisponível temporariamente.

10. Notas Importantes

  • Os dados de parentesco ajudam a identificar vínculos relevantes para análise de risco.
  • Esta consulta é recomendada para processos de compliance e auditorias mais robustas.
  • Certifique-se de enviar um CPF válido e formatado corretamente.