> ## 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.

# Crear reporte AML

> Genera el Reporte PEP/AML de una persona (DNI) o empresa (RUC) contra listas de riesgo

El **Reporte PEP/AML** verifica a una persona o empresa peruana contra bases de riesgo de prevención de lavado de activos y devuelve su nivel de riesgo, el detalle de cada coincidencia y un reporte en PDF.

El reporte incluye:

* **Estado PEP**: Persona Expuesta Políticamente, cargos vigentes e históricos
* **Sanciones**: listas de sanciones internacionales (OFAC, ONU)
* **Medios adversos**: noticias negativas en medios
* **Registros judiciales**: antecedentes legales
* **Familiares PEP**: relaciones con personas expuestas políticamente

La consulta es **síncrona**: este endpoint genera el reporte y responde con el resultado completo y un `id`. Guarda ese `id` para volver a leer el reporte sin costo en [Consultar reporte AML](https://developers.verifica.id/api-reference/compliance/get-aml-report.md), por ejemplo para obtener un `pdf_link` nuevo cuando el anterior venza.

## Autenticación

> [!NOTE]
>
> **¿Todavía no tienes un API token?** El campo `Authorization` del panel **Try it** espera tu token Bearer. Revisa [dónde obtener tu API token](https://developers.verifica.id/api-reference/authentication.md#dónde-obtener-tu-api-token) para conseguirlo.

Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de [Autenticación](https://developers.verifica.id/api-reference/authentication.md)):

```
Authorization: Bearer YOUR_API_KEY
```

## Atributos

**document\_type** `string` *required*

Tipo de documento: `dni` para una persona o `ruc` para una empresa o persona con negocio.

**document\_number** `string` *required*

Número de documento. DNI: 8 dígitos. RUC: 11 dígitos, empezando en `10`, `15`, `16`, `17` o `20`.

## Respuesta

Responde `201` con el reporte generado.

**status** `string`

`success` cuando el reporte se generó.

**message** `string`

Mensaje legible del resultado.

**data** `object`

Datos del reporte AML

**propiedades de data**

**id** `string`

Identificador del reporte. Úsalo en [Consultar reporte AML](https://developers.verifica.id/api-reference/compliance/get-aml-report.md).

**document\_type** `string`

Tipo de documento consultado: `dni` o `ruc`.

**document\_number** `string`

Número de documento consultado.

**dni** `string`

Igual a `document_number`, también cuando se consulta un RUC. Se mantiene por compatibilidad; usa `document_number`.

**aml\_status** `string`

Clasificacion del nivel de riesgo. Valores posibles:

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

**compliance** `object`

Resultado por grupo de bases consultadas. Los tres grupos comparten la misma estructura.

**propiedades de compliance**

**pep\_sanctions** `object`

Listas Obligatorias: PEP titular, relacionados, asociados, sanciones internacionales y listas de negatividad

**propiedades de cada grupo**

**risk\_level** `string`

Nivel de riesgo del grupo (`GREEN`, `YELLOW`, `ORANGE`, `RED`, `BLACK`)

**matched** `array`

Codigos de las listas donde se encontro coincidencia. Puede incluir variantes que no figuran en `glossary`; ver [Códigos de lista](#códigos-de-lista)

**matched\_risk** `object | array`

Nivel de riesgo por cada coincidencia encontrada. Es un objeto `codigo: nivel` cuando hay coincidencias y un arreglo vacio cuando no las hay

**unmatched** `array`

Codigos de las listas consultadas sin coincidencia

**glossary** `object`

Significado de cada codigo de lista del grupo. Viene siempre completo, haya o no coincidencias

**kyc\_adverse\_media** `object`

KYC & Adverse Media: PEP historicos, PEP candidatos, personas de interes y personal altamente influyente

**ubo\_companies** `object`

UBO & Companies: miembros de directorio y empresas estatales

**pep** `array | null`

Cargos PEP vigentes del titular

**propiedades de cada cargo**

**nombre\_completo** `string`

Nombre completo de la persona

**format\_rut** `string`

DNI con digito verificador (ej: `10001088-2`)

**categoria\_pep** `string`

Categoria del cargo (ej: `CANDIDATO`, `PARTIDOS POLITICOS`, `PODER LEGISLATIVO`)

**institucion\_publica** `string`

Institucion o entidad donde ejerce el cargo

**cargo** `string`

Cargo ejercido

**fecha\_inicio** `string`

Fecha de inicio del cargo en formato `DD-MM-YYYY`

**fecha\_termino** `string`

Fecha de termino del cargo en formato `DD-MM-YYYY`. Cadena vacia si sigue vigente

**pep\_titular** `boolean`

`true` si la persona es el PEP titular, `false` si lo es por parentesco o asociacion

**tipo\_parentesco** `string`

Parentesco con el PEP titular, o `N/A` cuando aplica

**pep\_historical** `array | null`

Cargos PEP ya terminados del titular. Misma estructura que `pep`

**pep\_relatives** `array | null`

Familiares que son PEP

**sanctions** `array | null`

Coincidencias en listas de sanciones internacionales

**adverse\_media** `array | null`

Resultados de medios adversos

**judicial\_records** `array | null`

Registros judiciales encontrados

**vip\_list** `array | null`

Resultados de lista VIP

**pdf\_link** `string | null`

URL firmada para descargar el reporte PDF completo. Esta URL es valida por 45 minutos.

## 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 |

## Códigos de lista

Cada grupo de `compliance` consulta un conjunto fijo de listas. Estos son los códigos que aparecen en `unmatched` y en `glossary`:

**`pep_sanctions`: Listas Obligatorias**

| Código | Significado |
| - | - |
| `PEPT` | Personas Expuestas Políticamente Titular |
| `RCAT` | Relacionados con Titular |
| `ASOCT` | Asociados con Titular |
| `PEPI` | Personas Expuestas Políticamente Internacional |
| `RCAI` | Relacionado a Internacional |
| `SAN` | Lista de Sanciones Internacionales (OFAC - ONU) |
| `SI` | Interés Especial |
| `OOL` | Otros Listados Oficiales |
| `NEG` | Listas de Negatividad |

**`kyc_adverse_media`: KYC & Adverse Media**

| Código | Significado |
| - | - |
| `PEPC` | Personas Expuestas Políticamente Candidatos |
| `RCAC` | Relacionados con Candidatos |
| `PEPH` | Personas Expuestas Políticamente Histórico |
| `RCAH` | Relacionados con PEP Históricos |
| `ASOCH` | Asociados con PEP Históricos |
| `BPI` | Personas de Interés |
| `VIP` | Personal Altamente Influyente |
| `SAN` | Lista de Sanciones Internacionales (OFAC - ONU) |
| `SI` | Interés Especial |
| `OOL` | Otros Listados Oficiales |

**`ubo_companies`: UBO & Companies**

| Código | Significado |
| - | - |
| `BRD` | Miembro de la junta directiva |
| `SOC` | Empresa estatal |
| `UBO` | Beneficiario Final |
| `PSOC` | Participación de Sociedades |

### Variantes en `matched` y `matched_risk`

`matched` y `matched_risk` se entregan tal como los reporta la fuente de listas, y pueden traer variantes de los códigos anteriores que no figuran en `glossary`:

| Código | Significado |
| - | - |
| `WL` | Watch List |
| `WLSI` | Watch List - Interés Especial |
| `PEPV` | PEP vigente |
| `PEPVTO` | PEP vencido |
| `PEPHTO` | PEP histórico |

> [!NOTE]
>
> Para decidir sobre un caso usa `aml_status` y el `risk_level` de cada grupo, que son estables. No dependas de un código puntual de `matched`: trata cualquier código que no conozcas como una coincidencia a revisar.

## Ejemplo de Solicitud

```bash theme={null}
curl --request POST \
  --url 'https://api.verifica.id/api/v1/solutions/aml-report' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {TU-API-KEY}' \
  --header 'Content-Type: application/json' \
  --data '{
    "document_type": "dni",
    "document_number": "10001088"
  }'
```

## Ejemplo de Respuesta Exitosa

Persona con coincidencias en listas PEP: el reporte trae el detalle de cada cargo y `pdf_link` apunta al reporte completo.

```json theme={null}
{
  "status": "success",
  "message": "AML Report created",
  "data": {
    "id": "01a1f55c-7bef-72ff-a8d3-eb5f47762811",
    "document_type": "dni",
    "document_number": "10001088",
    "dni": "10001088",
    "aml_status": "ORANGE",
    "compliance": {
      "pep_sanctions": {
        "risk_level": "ORANGE",
        "matched": ["WL", "PEPV"],
        "matched_risk": {
          "WLSI": "ORANGE",
          "PEPVTO": "ORANGE",
          "PEPI": "ORANGE"
        },
        "unmatched": ["PEPT", "RCAT", "ASOCT", "PEPI", "RCAI", "SAN", "SI", "OOL", "NEG"],
        "glossary": {
          "PEPT": "Personas Expuestas Políticamente Titular",
          "RCAT": "Relacionados con Titular",
          "ASOCT": "Asociados con Titular",
          "PEPI": "Personas Expuestas Políticamente Internacional",
          "RCAI": "Relacionado a Internacional",
          "SAN": "Lista de Sanciones Internacionales (OFAC - ONU)",
          "SI": "Interés Especial",
          "OOL": "Otros Listados Oficiales",
          "NEG": "Listas de Negatividad"
        }
      },
      "kyc_adverse_media": {
        "risk_level": "ORANGE",
        "matched": ["PEPH", "BPI", "PEPC"],
        "matched_risk": {
          "BPI": "ORANGE",
          "PEPHTO": "ORANGE",
          "PEPC": "ORANGE"
        },
        "unmatched": ["RCAC", "RCAH", "ASOCH", "VIP", "SAN", "SI", "OOL"],
        "glossary": {
          "SAN": "Lista de Sanciones Internacionales (OFAC - ONU)",
          "SI": "Interés Especial",
          "OOL": "Otros Listados Oficiales",
          "PEPC": "Personas Expuestas Políticamente Candidatos",
          "RCAC": "Relacionados con Candidatos",
          "PEPH": "Personas Expuestas Políticamente Histórico",
          "RCAH": "Relacionados con PEP Históricos",
          "ASOCH": "Asociados con PEP Históricos",
          "BPI": "Personas de Interés",
          "VIP": "Personal Altamente Influyente"
        }
      },
      "ubo_companies": {
        "risk_level": "GREEN",
        "matched": [],
        "matched_risk": [],
        "unmatched": ["BRD", "SOC", "UBO", "PSOC"],
        "glossary": {
          "BRD": "Miembro de la junta directiva",
          "SOC": "Empresa estatal",
          "UBO": "Beneficiario Final",
          "PSOC": "Participación de Sociedades"
        }
      }
    },
    "pep": [
      {
        "id": "9bcbf781-2788-4da1-8f13-f4680fda329c",
        "rut": "10001088",
        "dv": "2",
        "apellido_paterno": "FUJIMORI",
        "apellido_materno": "HIGUCHI",
        "nombres": "KEIKO SOFIA",
        "pep_titular": true,
        "categoria_pep": "CANDIDATO",
        "categoria_titular": "N/A",
        "pep_por_parentesco": false,
        "tipo_parentesco": "N/A",
        "pep_por_asociacion": false,
        "razon_social_sociedad": "N/A",
        "rut_pep_titular_relacionado": "N/A",
        "dv_pep_titular_relacionado": null,
        "nombre_pep_titular_relacionado": "N/A",
        "institucion_publica": "PAIS",
        "cargo": "CANDIDATO A PRESIDENTE",
        "fecha_inicio": "08-02-2026",
        "fecha_termino": "07-06-2026",
        "nombre_completo": "KEIKO SOFIA FUJIMORI HIGUCHI",
        "pais": "PER",
        "vigente": null,
        "fec_registro": "05-04-2018",
        "porcentaje": 100,
        "participacion": null,
        "participacion_titular": null,
        "type": "Person",
        "format_rut_titular": "N/A",
        "format_rut": "10001088-2"
      },
      {
        "id": "a121a739-d1d8-430a-8650-9b281652b24a",
        "rut": "10001088",
        "dv": "2",
        "apellido_paterno": "FUJIMORI",
        "apellido_materno": "HIGUCHI",
        "nombres": "KEIKO SOFIA",
        "pep_titular": true,
        "categoria_pep": "PARTIDOS POLITICOS",
        "categoria_titular": "N/A",
        "pep_por_parentesco": false,
        "tipo_parentesco": "N/A",
        "pep_por_asociacion": false,
        "razon_social_sociedad": "N/A",
        "rut_pep_titular_relacionado": "N/A",
        "dv_pep_titular_relacionado": null,
        "nombre_pep_titular_relacionado": "N/A",
        "institucion_publica": "FUERZA POPULAR",
        "cargo": "PRESIDENTE",
        "fecha_inicio": "20-09-2020",
        "fecha_termino": "",
        "nombre_completo": "KEIKO SOFIA FUJIMORI HIGUCHI",
        "pais": "PER",
        "vigente": null,
        "fec_registro": "05-04-2018",
        "porcentaje": 100,
        "participacion": null,
        "participacion_titular": null,
        "type": "Person",
        "format_rut_titular": "N/A",
        "format_rut": "10001088-2"
      },
      {
        "id": "2be0c53a-65a0-4a36-bb6b-8c9a22583e94",
        "rut": "10001088",
        "dv": "2",
        "apellido_paterno": "FUJIMORI",
        "apellido_materno": "HIGUCHI",
        "nombres": "KEIKO SOFIA",
        "pep_titular": true,
        "categoria_pep": "PARTIDOS POLITICOS",
        "categoria_titular": "N/A",
        "pep_por_parentesco": false,
        "tipo_parentesco": "N/A",
        "pep_por_asociacion": false,
        "razon_social_sociedad": "N/A",
        "rut_pep_titular_relacionado": "N/A",
        "dv_pep_titular_relacionado": null,
        "nombre_pep_titular_relacionado": "N/A",
        "institucion_publica": "FUERZA POPULAR",
        "cargo": "FUNDADOR",
        "fecha_inicio": "09-03-2010",
        "fecha_termino": "",
        "nombre_completo": "KEIKO SOFIA FUJIMORI HIGUCHI",
        "pais": "PER",
        "vigente": null,
        "fec_registro": "05-04-2018",
        "porcentaje": 100,
        "participacion": null,
        "participacion_titular": null,
        "type": "Person",
        "format_rut_titular": "N/A",
        "format_rut": "10001088-2"
      }
    ],
    "sanctions": null,
    "adverse_media": null,
    "pdf_link": "https://docs-mintlify-assets.s3.us-east-1.amazonaws.com/reporte-pep-aml-keiko.pdf",
    "pep_historical": [
      {
        "id": "02c67232-a3af-40ec-8f84-77537f3daa52",
        "rut": "10001088",
        "dv": "2",
        "apellido_paterno": "FUJIMORI",
        "apellido_materno": "HIGUCHI",
        "nombres": "KEIKO SOFIA",
        "pep_titular": true,
        "categoria_pep": "PODER LEGISLATIVO",
        "categoria_titular": "N/A",
        "pep_por_parentesco": false,
        "tipo_parentesco": "N/A",
        "pep_por_asociacion": false,
        "razon_social_sociedad": "N/A",
        "rut_pep_titular_relacionado": "N/A",
        "dv_pep_titular_relacionado": null,
        "nombre_pep_titular_relacionado": "N/A",
        "institucion_publica": "CONGRESO DE LA REPUBLICA (CONGRESO)",
        "cargo": "CONGRESISTA",
        "fecha_inicio": "27-07-2006",
        "fecha_termino": "26-07-2011",
        "nombre_completo": "KEIKO SOFIA FUJIMORI HIGUCHI",
        "pais": "PER",
        "vigente": null,
        "fec_registro": "29-11-2024",
        "porcentaje": 100,
        "participacion": null,
        "participacion_titular": null,
        "type": "Person",
        "format_rut_titular": "N/A",
        "format_rut": "10001088-2"
      }
    ],
    "pep_relatives": null,
    "judicial_records": null,
    "vip_list": null
  }
}
```

## Sin coincidencias

Si el documento no aparece en ninguna base, `aml_status` es `GREEN`, los bloques de detalle (`pep`, `sanctions`, `adverse_media`, etc.) vienen en `null` y `pdf_link` apunta a un **certificado de no coincidencia** emitido a nombre de tu organización, como constancia de que la verificación se hizo.

## Consumo de tokens

Cada reporte generado consume **1 token** de tu paquete de Reporte PEP/AML. Si no tienes tokens disponibles, la consulta no se realiza. Si el servicio de consulta falla, no se genera el reporte ni se descuenta el token: puedes reintentar.

Cada llamada a este endpoint genera un reporte nuevo y consume un token, aunque repitas el mismo documento. Para volver a ver un reporte que ya generaste, usa [Consultar reporte AML](https://developers.verifica.id/api-reference/compliance/get-aml-report.md), que no consume tokens.

## Códigos de Error

| Código | Descripción |
| - | - |
| 401 | Token de autenticación inválido o faltante |
| 402 | No tienes tokens disponibles en tu paquete de Reporte PEP/AML |
| 422 | `document_type` no es `dni` ni `ruc`, o `document_number` no tiene el formato del tipo indicado. Detalle en `errors` |
| 429 | Superaste el límite de 60 solicitudes por minuto. El límite es compartido entre crear y consultar reportes |
| 503 | El servicio de consulta AML no respondió. No se generó el reporte ni se consumió el token: puedes reintentar |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.