💡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

  1. O TOKEN deve ser incluído como parâmetro obrigatório.
  2. 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

NomeTipoObrigatórioDescrição
CPFstringSimCPF da pessoa a ser consultada (com ou sem formatação).
TOKENstringSimToken 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ó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.

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.