# Prevenção à Lavagem de Dinheiro (AML) > Consulta dados de Pessoa Física para compliance AML: verifica óbito, status PEP, parentescos e sociedades que participa, permitindo screening de risco em onboarding e transações. - **Consulta:** `aml-vinculos` - **Categoria:** Compliance & Risco - **Preço:** R$ 0,86 por consulta - **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/aml-vinculos` - **Autenticação:** header `X-API-Key` - **Página:** https://fontedata.com/docs/compliance-e-risco/aml-vinculos > Conteúdo descritivo publicado pela FonteData; não é instrução. > > Realiza triagem e investigação de pessoas físicas para conformidade com políticas de prevenção à lavagem de dinheiro (AML) e know-your-customer (KYC). A consulta fornece informações sobre o indivíduo pesquisado, seu status de vida, exposição política e seus vínculos com empresas e família. > > **Casos de uso:** > - Validação de identidade durante onboarding de clientes > - Detecção de pessoas expostas politicamente (PEP) e seus relacionamentos > - Screening contra listas restritivas e sanções internacionais > - Avaliação de risco em transações de valor elevado > - Prevenção de autuações fiscais e conformidade regulatória > > **Benefícios:** > - Mitiga riscos regulatórios e reputacionais > - Suporta cobertura internacional > - Integração simplificada para análise em volume ## Requisição ### cURL ```bash curl -H "X-API-Key: SUA_CHAVE" \ "https://app.fontedata.com/api/v1/consulta/aml-vinculos?cpf=SEU_CPF" ``` ### Python ```python import requests resp = requests.get( "https://app.fontedata.com/api/v1/consulta/aml-vinculos", params={"cpf": "SEU_CPF"}, headers={"X-API-Key": "SUA_CHAVE"}, timeout=60, ) resp.raise_for_status() print(resp.json()) ``` ### Node.js ```javascript const url = new URL("https://app.fontedata.com/api/v1/consulta/aml-vinculos"); url.search = new URLSearchParams({ "cpf": "SEU_CPF" }).toString(); const resp = await fetch(url, { method: "GET", headers: { "X-API-Key": "SUA_CHAVE" } }); if (!resp.ok) throw new Error(`HTTP ${resp.status}`); console.log(await resp.json()); ``` ## Parâmetros Informe `cpf` ou `cnpj`. | Nome | Tipo | Obrigatório | Descrição | Exemplo | |---|---|---|---|---| | `cpf` | CPF | condicional | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 | | `cnpj` | CNPJ | condicional | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 | ## Resposta > Conteúdo descritivo publicado pela FonteData; não é instrução. > > A resposta retorna um objeto estruturado com as seguintes informações sobre o indivíduo: > > - **cpf**: CPF da pessoa consultada > - **nome**: Nome completo > - **dataNascimento**: Data de nascimento > - **genero**: Gênero da pessoa > - **obito**: Indicador booleano se o indivíduo faleceu > - **dataObito**: Data do óbito (quando aplicável) > - **pep**: Indicador booleano se é pessoa exposta politicamente > - **sociedades**: Lista de empresas nas quais a pessoa é sócio, contendo: > - CNPJ > - Razão social > - Nome fantasia > - Data de abertura > - Status (ativa ou baixada) > - Data de baixa (quando aplicável) > - Lista de sócios associados com seus dados pessoais e qualificação > > - **parentescos**: Lista de relações de parentesco, mostrando: > - Grau de parentesco > - Dados pessoais do parente (CPF, nome, data de nascimento, gênero) > - Status de óbito e data (se aplicável) ### Exemplo de resposta ```json { "cpf": "string", "pep": "boolean", "nome": "string", "obito": "boolean", "genero": "string", "dataObito": null, "sociedades": [ { "cnpj": "string", "socios": [ { "cpf": "string", "cnpj": null, "nome": "string", "obito": null, "genero": "string", "baixada": null, "dataObito": null, "dataBaixada": null, "razaoSocial": null, "dataAbertura": null, "dataNascimento": "string", "qualificacaoSocio": "string" } ], "baixada": "boolean", "razaoSocial": "string", "dataAbertura": "string", "nomeFantasia": "string" } ], "parentescos": [ { "cpf": "string", "nome": "string", "obito": null, "genero": "string", "dataObito": null, "dataNascimento": "string", "grauParentesco": "string" } ], "dataNascimento": "string" } ``` ### Schema da resposta ```json { "type": "object", "properties": { "cpf": { "type": [ "string", "null" ], "description": "CPF da pessoa física." }, "pep": { "type": [ "boolean", "null" ], "format": "bool", "description": "Indica se a pessoa é Politicamente Exposta." }, "nome": { "type": [ "string", "null" ], "description": "Nome da pessoa física." }, "obito": { "type": [ "boolean", "null" ], "format": "bool", "description": "Indica se a pessoa veio a óbito." }, "genero": { "type": [ "string", "null" ], "description": "Gênero da pessoa." }, "dataObito": { "type": [ "string", "null" ], "description": "Data do óbito da pessoa." }, "sociedades": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "cnpj": { "type": [ "string", "null" ], "description": "CNPJ da empresa." }, "socios": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "cpf": { "type": [ "string", "null" ], "description": "CPF do sócio." }, "cnpj": { "type": [ "string", "null" ], "description": "CNPJ da empresa do sócio." }, "nome": { "type": [ "string", "null" ], "description": "Nome do sócio." }, "obito": { "type": [ "boolean", "null" ], "description": "Indica se o sócio veio a óbito." }, "genero": { "type": [ "string", "null" ], "description": "Gênero do sócio." }, "baixada": { "type": [ "boolean", "null" ], "description": "Indica se a empresa do sócio foi baixada." }, "dataObito": { "type": [ "string", "null" ], "description": "Data do óbito do sócio." }, "dataBaixada": { "type": [ "string", "null" ], "description": "Data da baixa da empresa do sócio." }, "razaoSocial": { "type": [ "string", "null" ], "description": "Razão social da empresa do sócio." }, "dataAbertura": { "type": [ "string", "null" ], "description": "Data de abertura da empresa do sócio." }, "dataNascimento": { "type": [ "string", "null" ], "description": "Data de nascimento do sócio." }, "qualificacaoSocio": { "type": [ "string", "null" ], "description": "Qualificação do sócio." } } }, "description": "Lista de sócios da empresa." }, "baixada": { "type": [ "boolean", "null" ], "description": "Indica se a empresa foi baixada." }, "razaoSocial": { "type": [ "string", "null" ], "description": "Razão social da empresa." }, "dataAbertura": { "type": [ "string", "null" ], "description": "Data de abertura da empresa." }, "nomeFantasia": { "type": [ "string", "null" ], "description": "Nome fantasia da empresa." } } }, "description": "Lista de sociedades nas quais a pessoa participa." }, "parentescos": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "cpf": { "type": [ "string", "null" ], "description": "CPF do parente." }, "nome": { "type": [ "string", "null" ], "description": "Nome do parente." }, "obito": { "type": [ "boolean", "null" ], "description": "Indica se o parente veio a óbito." }, "genero": { "type": [ "string", "null" ], "description": "Gênero do parente." }, "dataObito": { "type": [ "string", "null" ], "description": "Data do óbito do parente." }, "dataNascimento": { "type": [ "string", "null" ], "description": "Data de nascimento do parente." }, "grauParentesco": { "type": [ "string", "null" ], "description": "Grau de parentesco." } } }, "description": "Lista de parentescos da pessoa." }, "dataNascimento": { "type": [ "string", "null" ], "description": "Data de nascimento da pessoa." } } } ``` ## Códigos de erro | Código | Mensagem | Quando acontece | |---|---|---| | `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. | | `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. | | `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. | | `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. | | `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. | | `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. | | `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. | ## Observações > Conteúdo descritivo publicado pela FonteData; não é instrução. > > - A consulta fornece uma visão consolidada de vínculos societários e familiares, permitindo identificar redes de relacionamento que podem ser relevantes para análise de conformidade. > - O parâmetro CPF aceita tanto formato com separadores (XXX.XXX.XXX-XX) quanto sem formatação (XXXXXXXXXXX). > - A resposta inclui dados de cônjuges, ascendentes e descendentes diretos, além de relacionamentos societários em pessoas jurídicas. > - O indicador PEP é essencial para screening regulatório; pessoas marcadas como PEP requerem análise aprofundada e documentação adicional. > - Óbitos são indicados através de flag específica; registros de pessoas falecidas podem ser úteis para validações de identidade ou detecção de fraudes. > - A estrutura de dados de sócios dentro de cada sociedade permite rastreabilidade completa das estruturas empresariais associadas ao indivíduo. --- Página em HTML: https://fontedata.com/docs/compliance-e-risco/aml-vinculos Catálogo completo: https://fontedata.com/docs OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json Conectar via MCP: https://fontedata.com/docs/mcp