Orientações e respostas da equipe da Direct Data

/api/AML

💡 Esta API permite consultar dados de uma Pessoa Física para identificar informações como se ela está associada a um óbito, se é PEP (Pessoa Exposta Politicamente), além de parentescos e sociedades das quais ela faz parte. Ideal para compliance, prevenção à lavagem de dinheiro e auditorias fiscais.

Introdução

A API AML (Anti Money Laundering - Vínculos Societários) é um recurso essencial para organizações que precisam realizar verificações detalhadas em Pessoas Físicas para prevenir autuações fiscais, lavagem de dinheiro e atender exigências de compliance/ESG. Os principais usuários são empresas do setor financeiro, jurídico e de auditoria.

URL Base

A API está hospedada no seguinte endereço:

https://api.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

Para acessar esta API, é necessário fornecer um token de autenticação. Em caso de dúvidas, acesse a área de criptografia na app.

Regras de Autenticação

1. O token deve ser passado como parâmetro na URL da requisição.
2. O token é essencial para realizar consultas.

Campos da API

Dados Pessoais

• CPF: Cadastro de Pessoa Física.
• Nome: Nome completo.
• Data de Nascimento: Data de nascimento da pessoa.
• Gênero: Masculino ou Feminino.

Status

• Flag isPEP: Indica se a pessoa é PEP.
• Flag Óbito: Indica se a pessoa é falecida.
• Data de Óbito: Data em que a pessoa faleceu (se aplicável).

Parentescos

• Lista de Parentesco: Detalhes sobre parentes.
  • Grau de Parentesco
  • Nome
  • CPF
  • Data de Nascimento
  • Flag Óbito

Sociedades

• CNPJ: Cadastro Nacional de Pessoa Jurídica.
• Razão Social
• Nome Fantasia
• Data de Abertura
• Flag Baixada: Indica se a empresa está baixada.
• Lista de Sócios:
  • Nome
  • CPF
  • Data de Nascimento
  • Qualificação do Sócio

Parâmetros

Exemplos de Requisição

Usando cURL

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

Respostas

Sucesso (200)

{
  "metaDados": {
    "consultaNome": "AML - Anti Money Laundering (Vínculos Societários)",
    "consultaUid": "direct-123456",
    "usuario": "Kaio",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 3060
  },
  "retorno": {
    "cpf": "123.456.789-09",
    "nome": "JOÃO SILVA",
    "dataNascimento": "15/03/1980",
    "genero": "Masculino",
    "isPEP": false,
    "isObito": false,
    "sociedades": [
      {
        "cnpj": "00.000.000/0001-00",
        "razaoSocial": "EMPRESA EXEMPLO LTDA",
        "nomeFantasia": "EXEMPLO",
        "dataAbertura": "10/01/2000",
        "baixada": false
      }
    ]
  }
}

Erros Comuns

Notas Importantes

• Esta API é assíncrona em algumas condições e não gera comprovantes.
• Certifique-se de ter saldo suficiente para realizar consultas.