Screening AML

Verifica un nombre o razón social contra las listas de sanciones internacionales (OFAC de EE.UU. y ONU). Útil para procesos de cumplimiento (KYC/AML) y debida diligencia de clientes y proveedores.

URL

GET /api/aml?nombre=PUTIN&documento=12345678

Parámetros

Parámetro Tipo Descripción
nombre string (requerido) Nombre completo o razón social a verificar. Mínimo 3 caracteres.
documento string (opcional) DNI o RUC asociado, para afinar la coincidencia.

Fuente

Listas OFAC (EE.UU.) y ONU, actualizadas periódicamente; se consultan en memoria. El campo listasActualizadas indica la fecha de la última carga. Las coincidencias pueden ser exactas o parciales: revisa siempre el campo coincidencia antes de tomar una decisión.

Ejemplo de request

curl -X GET "https://apisperu.gsalinas.site/api/aml?nombre=PUTIN" \
  -H "Authorization: Bearer apk_demo_apisperu_pub_2BfHK7nN4tV9X8jE3LpQ5sUcZ"

Ejemplo de response

{
  "ok": true,
  "data": {
    "query": "PUTIN",
    "total": 1,
    "listasActualizadas": "2026-05-26T...Z",
    "matches": [
      {
        "nombre": "PUTIN, Vladimir Vladimirovich",
        "fuente": "OFAC",
        "programa": "RUSSIA-EO14024",
        "tipo": "individual",
        "coincidencia": "parcial"
      }
    ]
  }
}

Cuando no hay coincidencias la respuesta sigue siendo ok: true con total: 0 y matches: [].

Campos del response

Campo Tipo Descripción
query string Nombre consultado (normalizado).
documento string? Documento consultado, si se envió.
total number Cantidad de coincidencias encontradas (0 si no hay).
listasActualizadas string Fecha ISO de la última actualización de las listas.
truncado boolean? true si se recortaron resultados por exceder el máximo.
matches array Lista de coincidencias (ver campos abajo). Vacía si no hay.

Campos de cada coincidencia (matches[])

Campo Tipo Descripción
nombre string Nombre tal como aparece en la lista de sanciones.
fuente 'OFAC' | 'ONU' Lista de origen de la coincidencia.
programa string? Programa de sanción (ej. RUSSIA-EO14024).
tipo string? Tipo de entidad (individual, entity, vessel, etc.).
coincidencia 'exacto' | 'parcial' Nivel de coincidencia entre la consulta y el nombre listado.

Errores específicos

Probar en el playground