Global Watch List

El proceso de Global Watch List realiza una búsqueda automatizada y exhaustiva en cientos de listas de sanciones internacionales, boletines de agencias de cumplimiento de la ley (como la OFAC e Interpol) y registros globales de restricciones financieras. Su objetivo es detectar de forma temprana si un candidato u organización cuenta con alertas restrictivas vigentes a nivel internacional.

Comportamiento de la Bandera Detail

Nota técnica: El parámetro de consulta ?detail=true no genera variaciones estructurales ni expande la información de este endpoint. La API retorna el desglose completo de las coincidencias (detail) y los bloques de auditoría interna (qc) desde la primera llamada.

Estructura de Respuesta

La composición del JSON de respuesta contiene los siguientes elementos clave:

• detail (Array de Hallazgos): Contiene una lista dinámica con todas las coincidencias encontradas. Cada registro incluye la propiedad score (fuerza de la coincidencia) y un objeto extrafields con metadatos críticos como la autoridad emisora (authorities), la lista de referencia (list_reference_name) y la URL oficial de la fuente.
• qc (itemsEvaluated): Es un nodo de control y aseguramiento de calidad interna que desglosa de forma estructurada las alertas activas procesadas por el motor de reglas.

Ejemplo de Respuesta JSON

{
  "isSuccess": true,
  "statusCode": 200,
  "message": "Success",
  "data": {
    "processId": "698BbILPWd6I0oBGZOgk",
    "processName": "Global Watch List",
    "detail": [ // Array principal con el total de coincidencias detectadas en listas
      {
        "defendant": "RAMIREZ LOPEZ, CARLOS", // Nombre o alias registrado en la lista oficial
        "extrafields": {
          "address": "MX",
          "authorities": "U.S. Department of State", // Entidad gubernamental o internacional emisora
          "id": "11725",
          "list_reference_name": "Specially Designated Nationals (SDN) - Treasury Department", // Nombre de la lista restrictiva
          "nationality": "Mexico",
          "publication_date": "2025-09-25",
          "url": "https://sanctionslist.ofac.treas.gov/Home/SdnList" // Enlace oficial de consulta de la fuente
        },
        "id": "dat243consolidatedexcel-20250925002670",
        "index": "internationalv1",
        "score": 26.895287 // Puntaje o peso de la coincidencia fonética/nominal
      }
    ],
    "allowClientView": true,
    "status": "Finalizado",
    "result": "No Aprobado", // Dictamen definitivo basado en la presencia de registros críticos
    "start": 1777569225576,
    "end": 1777583512717,
    "time": "00:00:18",
    "qc": { // Bloque de aseguramiento y auditoría de calidad interno
      "comments": [ "NA" ],
      "itemsEvaluated": {
        "general": [ ... ],
        "current": [
          {
            "defendant": "CARLOS RAMIREZ LOPEZ",
            "extrafields": {
              "addresses": "MEXICO",
              "authorities": "U.S. DEPARTMENT OF THE TREASURY",
              "organ": "OFFOFAC OF FOREIGN ASSETS CONTROL",
              "programs": "SDNTK" // Programa normativo o regulatorio asociado
            }
          }
        ]
      }
    }
  }
}