Listas de sanciones y PEP

Revisamos nombres contra listas oficiales de sanciones (OFAC SDN y Consolidated, Consejo de Seguridad de la ONU), listas de Personas Políticamente Expuestas y las listas propias de tu cuenta (por ejemplo la Lista de Personas Bloqueadas de la UIF que recibes como sujeto obligado).

Hay dos formas:

Dentro de una evaluación: screen=true en POST /v1/score con person.full_name. El resultado viene en screening y suma razones al score.
Sola: POST /v1/screen, sin score de fraude.

Ambas necesitan el permiso screen.

`POST /v1/screen`

curl -s "$SAFEGATE_URL/v1/screen" \
  -H "Authorization: Bearer $SAFEGATE_KEY" -H "Content-Type: application/json" \
  -d '{"full_name": "Sancho Sandbox Sancionado", "date_of_birth": "1970-01-01", "nationality": "MX"}'

Campo	Notas
`full_name`	Obligatorio
`entity_type`	`person` (por defecto) u `organization`
`date_of_birth`, `nationality`	Mejoran la precisión: una fecha que coincide sube el puntaje, una que no coincide lo baja
`curp`, `rfc`, `passport`	Una coincidencia exacta de identificador es coincidencia segura
`lists`	Limita la búsqueda a esos ids de lista (`ofac_sdn`, `un_sc`, el id de tu lista…)

Resultado

`status`	Significa	Qué hacer
`clear`	Sin coincidencias sobre el umbral	Continuar
`potential_match`	Parecido, no idéntico	Revisión humana
`match`	Coincidencia fuerte	Bloquear y seguir tu procedimiento de cumplimiento
`unavailable`	Las listas no estaban disponibles	No lo trates como limpio. En `/v1/screen` regresa 503; en `/v1/score` la señal queda en `error`

Cada hit trae list, kind (sanction o pep), entity_id, matched_name, score (0–1) y una explanation legible de por qué coincidió. lists_version identifica exactamente qué versión de las listas se usó: guárdala como evidencia.

Umbrales

Por defecto, potential_match desde 0.80 y match desde 0.92. Tu cuenta puede ajustarlos con PUT /v1/settings dentro de rangos seguros (potencial 0.75–0.85, coincidencia 0.85–1.0). Cada resultado incluye los thresholds con que se clasificó.

Nombres en español

El buscador entiende nombres mexicanos: acentos, orden de apellidos, partículas ("de la", "del"), errores de captura y variantes fonéticas (Gonzalez / Gonsales). Los apellidos comunes pesan menos que los raros, así que "María García" no coincide con cualquier María García de una lista.