💡Permite consultar dados de uma Pessoa Física, se ela possui óbito, se é PEP, além de seus parentescos e sociedades que participa.
Introdução
A API AML (Anti Money Laundering - Vínculos Societários) permite consultar dados de uma Pessoa Física, incluindo se ela possui óbito, se é PEP (Pessoa Exposta Politicamente), além de seus parentescos e sociedades das quais participa. Ideal para compliance, prevenção à lavagem de dinheiro, auditorias fiscais e análise de risco.
Fonte: Fornecedor Externo
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br
Endpoint
GET /api/AML
Descrição: Endpoint para realizar consultas AML - Vínculos Societários.
Nota: Esta consulta não gera comprovantes.
Autenticação
A autenticação é feita utilizando um TOKEN. Sem um token válido, o acesso será negado (401
).
Regras de Autenticação
- O
TOKEN
deve ser incluído como parâmetro obrigatório. - Caso o token seja inválido ou expirado, entre em contato pelo e-mail: suporte@directd.com.br.
Campos da API
Campos Retornados
- CPF
- Nome
- Data de Nascimento
- Gênero
- Flag isPEP
- Flag PEP
- Flag Óbito
- Flag Tem Óbito
- Data de Óbito
- Lista de Parentesco
- Grau de Parentesco
- Nome
- CPF
- Data de Nascimento
- Gênero
- Flag Óbito
- Data de Óbito
- Lista de Sociedades
- CNPJ
- Razão Social
- Nome Fantasia
- Data de Abertura
- Flag Baixada
- Data Baixada
- Lista de Sócios
- Nome
- CPF
- Data de Nascimento
- Gênero
- Flag Óbito
- Data de Óbito
- CNPJ
- Razão Social
- Data de Abertura
- Flag Baixada
- Data Baixada
- Qualificação do Sócio
Parâmetros
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
CPF | string | Sim | CPF da pessoa a ser consultada (com ou sem formatação). |
TOKEN | string | Sim | Token de autenticação necessário para a consulta. |
Exemplo de Requisição
Usando cURL
curl 'https://apiv3.directd.com.br/api/AML?CPF=12345678909&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
A consulta foi realizada com sucesso e retorna os dados solicitados.
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"cpf": "string",
"nome": "string",
"dataNascimento": "string",
"genero": "string",
"isPEP": true,
"isObito": true,
"obito": true,
"pep": true,
"dataObito": "string",
"parentescos": [
{
"grauParentesco": "string",
"cpf": "string",
"nome": "string",
"dataNascimento": "string",
"genero": "string",
"isObito": true,
"obito": true,
"dataObito": "string"
}
],
"sociedades": [
{
"cnpj": "string",
"razaoSocial": "string",
"nomeFantasia": "string",
"dataAbertura": "string",
"baixada": true,
"dataBaixada": "string",
"socios": [
{
"cpf": "string",
"nome": "string",
"dataNascimento": "string",
"genero": "string",
"isObito": true,
"obito": true,
"dataObito": "string",
"cnpj": "string",
"razaoSocial": "string",
"dataAbertura": "string",
"baixada": true,
"dataBaixada": "string",
"qualificacaoSocio": "string"
}
]
}
]
}
}
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. |
Aplicações
- Prevenção de Autuações Fiscais
- Prevenção de Lavagem de Dinheiro
- Compliance/ESG
Notas Importantes
- O valor da consulta é de R$ 0,72.
- Esta API é assíncrona em algumas condições e não gera comprovantes.
- Certifique-se de ter saldo suficiente para realizar consultas.
- Para dúvidas ou suporte, entre em contato pelo e-mail: suporte@directd.com.br.