💡 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:
- O token deve ser enviado como parâmetro na URL da requisição.
- 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
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
CPF | string | Sim | CPF da pessoa a ser consultada. |
TOKEN | string | Sim | Token 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ódigo | Descrição |
---|---|
400 | Requisição inválida: parâmetros incorretos. |
401 | Não autenticado: token inválido ou ausente. |
403 | Não autorizado: saldo insuficiente para realizar a consulta. |
404 | Não encontrado: registro não localizado. |
408 | Tempo esgotado: consulta não foi concluída no prazo. |
500 | Erro interno: falha no processamento da consulta. |
503 | Serviç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.