> ## Documentation Index
> Fetch the complete documentation index at: https://developers.verifica.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener Reporte AML

> Obtiene un reporte completo de Anti-Lavado de Dinero para verificar personas contra listas de riesgo

## Descripcion

Este endpoint realiza una verificacion completa de AML (Anti-Lavado de Dinero) para un individuo peruano. El servicio evalua el nivel de riesgo consultando multiples bases de datos y genera un reporte detallado de cumplimiento.

El reporte incluye:

* **Estado PEP**: Persona Expuesta Politicamente
* **Sanciones**: Listas de sanciones internacionales
* **Medios adversos**: Noticias negativas en medios
* **Registros judiciales**: Antecedentes legales
* **Familiares PEP**: Relaciones con personas expuestas politicamente

## Autenticacion

Este endpoint requiere autenticacion Bearer. Incluye tu API key en el header Authorization:

```
Authorization: Bearer YOUR_API_KEY
```

## Parametros de Consulta

<ParamField query="dni" type="string" required>
  DNI (documento nacional de identidad) de la persona a verificar
</ParamField>

## Respuesta

<ResponseField name="status" type="string">
  Estado de la respuesta (ej: "success")
</ResponseField>

<ResponseField name="message" type="string">
  Mensaje de respuesta
</ResponseField>

<ResponseField name="data" type="object">
  Datos del reporte AML

  <Expandable title="propiedades de data">
    <ResponseField name="dni" type="string">
      DNI de la persona verificada
    </ResponseField>

    <ResponseField name="aml_status" type="string">
      Clasificacion del nivel de riesgo. Valores posibles:

      * `GREEN`: Sin riesgo detectado
      * `YELLOW`: Riesgo bajo
      * `ORANGE`: Riesgo medio
      * `RED`: Riesgo alto
      * `BLACK`: Riesgo critico
    </ResponseField>

    <ResponseField name="compliance" type="object">
      Resumen de indicadores de cumplimiento

      <Expandable title="propiedades de compliance">
        <ResponseField name="pep_sanctions" type="boolean | null">
          Indicador de PEP (Persona Expuesta Politicamente) o sanciones
        </ResponseField>

        <ResponseField name="kyc_adverse_media" type="boolean | null">
          Indicador de medios adversos
        </ResponseField>

        <ResponseField name="ubo_companies" type="boolean | null">
          Indicador de Beneficiario Final Efectivo de empresas
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="pep" type="array | null">
      Detalles de resultados PEP actuales
    </ResponseField>

    <ResponseField name="pep_historical" type="array | null">
      Resultados historicos de PEP
    </ResponseField>

    <ResponseField name="pep_relatives" type="array | null">
      Familiares que son PEP
    </ResponseField>

    <ResponseField name="sanctions" type="array | null">
      Coincidencias en listas de sanciones internacionales
    </ResponseField>

    <ResponseField name="adverse_media" type="array | null">
      Resultados de medios adversos
    </ResponseField>

    <ResponseField name="judicial_records" type="array | null">
      Registros judiciales encontrados
    </ResponseField>

    <ResponseField name="vip_list" type="array | null">
      Resultados de lista VIP
    </ResponseField>

    <ResponseField name="pdf_link" type="string | null">
      URL firmada para descargar el reporte PDF completo. Esta URL es valida por 45 minutos.
    </ResponseField>
  </Expandable>
</ResponseField>

## Niveles de Riesgo

| Estado   | Descripcion                                    |
| -------- | ---------------------------------------------- |
| `GREEN`  | Sin coincidencias en bases de datos de riesgo  |
| `YELLOW` | Coincidencias menores que requieren revision   |
| `ORANGE` | Coincidencias moderadas que requieren atencion |
| `RED`    | Coincidencias significativas - alto riesgo     |
| `BLACK`  | Coincidencias criticas - riesgo maximo         |

## Ejemplo de Solicitud

```bash theme={null}
curl -X GET "https://prd-api.verifica.id/api/v1/solutions/aml-report?dni=12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Ejemplo de Respuesta Exitosa

```json theme={null}
{
  "status": "success",
  "message": "AML report retrieved successfully",
  "data": {
    "dni": "12345678",
    "aml_status": "GREEN",
    "compliance": {
      "pep_sanctions": false,
      "kyc_adverse_media": false,
      "ubo_companies": false
    },
    "pep": [],
    "pep_historical": [],
    "pep_relatives": [],
    "sanctions": [],
    "adverse_media": [],
    "judicial_records": [],
    "vip_list": [],
    "pdf_link": "https://s3.amazonaws.com/bucket/report.pdf?signature=..."
  }
}
```

## Ejemplo de Respuesta con Riesgo

```json theme={null}
{
  "status": "success",
  "message": "AML report retrieved successfully",
  "data": {
    "dni": "87654321",
    "aml_status": "RED",
    "compliance": {
      "pep_sanctions": true,
      "kyc_adverse_media": true,
      "ubo_companies": false
    },
    "pep": [
      {
        "name": "Juan Perez",
        "position": "Funcionario Publico",
        "entity": "Ministerio de Economia"
      }
    ],
    "pep_historical": [],
    "pep_relatives": [],
    "sanctions": [],
    "adverse_media": [
      {
        "source": "Diario Nacional",
        "date": "2024-01-15",
        "title": "Investigacion por irregularidades"
      }
    ],
    "judicial_records": [],
    "vip_list": [],
    "pdf_link": "https://s3.amazonaws.com/bucket/report.pdf?signature=..."
  }
}
```

## Codigos de Error

| Codigo | Descripcion                                       |
| ------ | ------------------------------------------------- |
| 401    | Token de autenticacion invalido o faltante        |
| 422    | Error de validacion - el campo `dni` es requerido |