Hacer screening de sanciones es verificar si un cliente, proveedor o contraparte está en una lista de sanciones antes de hacer negocios con él. En Estados Unidos la lista que importa es la de OFAC: la lista SDN (Specially Designated Nationals) del Tesoro más sus listas no SDN, unas 20.000 personas, empresas, buques y aeronaves.
Desde hoy, POST /us/ofac/sanctions-screen/v1 recibe el nombre que tienes, con lo demás que sepas, y devuelve las partes de esas listas que pueden ser la misma. Cada una llega con un puntaje de 0 a 100 y lo que lo decidió.
Por qué no basta con buscar el nombre#
Los nombres nunca llegan como los escribe la lista. OFAC registra MADURO MOROS, Nicolas. Tu formulario de vinculación dice Nicolás Maduro Moros. Una búsqueda exacta no encuentra nada, y en screening "nada" es la respuesta equivocada más cara que existe.
El screening compara nombres como los lee un analista de cumplimiento:
- En cualquier orden:
Nicolas MaduroyMADURO MOROS, Nicolasson la misma persona. - Con errores y transliteraciones:
NicholasencuentraNicolas, yAero CarribeanencuentraAERO CARIBBEAN. - Con o sin tildes y puntuación:
NicolásyNicolascoinciden. - Con palabras unidas o separadas:
Al QaidayAlqaidacoinciden. - También los alias: se compara cada nombre principal y cada alias que registra OFAC.
También sabe qué no hace parecidos a dos nombres. Las formas societarias como LLC o S.A. no cuentan, así que dos empresas sin relación que comparten sufijo no se confunden. Y dos nombres que solo difieren en un número, como dos buques de una misma flota, no coinciden.
Cómo funciona#
El puntaje pondera lo que envías. El nombre decide la mayor parte, y lo demás confirma o descarta la coincidencia:
| Lo que envías | Peso | Qué hace |
|---|---|---|
name | 60 | Obligatorio. Se compara con errores, orden, tildes y alias |
birth_date | 25 | El mismo día suma, el mismo año cuenta en parte, otro año resta |
country | 15 | Un vínculo con el país suma, ninguno resta. Nombre en inglés o código ISO |
id_number | decide | Un pasaporte, documento o número tributario que coincide con uno que registra OFAC pone el puntaje en 100 |
Lo que no envías, o lo que OFAC no registra para una parte, no se compara, y su peso se reparte entre lo demás. Con solo el nombre, el nombre es todo el puntaje.
Pruébalo#
curl https://api.croma.run/us/ofac/sanctions-screen/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Nicolas Maduro",
"birth_date": "1962-11-23",
"country": "VE"
}'El nombre va en otro orden que en la lista y sin el segundo apellido, y aun así encuentra a la parte:
{
"as_of": "2026-10-13T21:30:34.860Z",
"threshold": 85,
"matched": true,
"count": 1,
"hits": [
{
"score": 97,
"matched_name": "MADURO MOROS, Nicolas",
"matched_on": "name",
"breakdown": {
"name": { "score": 95, "weight": 0.6 },
"birth_date": { "result": "match", "score": 100, "weight": 0.25, "value": "23 Nov 1962" },
"country": { "result": "match", "score": 100, "weight": 0.15, "value": "Venezuela" },
"id_number": { "result": "not_compared", "value": null }
},
"party": {
"id": "sdn-22790",
"list": "sdn",
"name": "MADURO MOROS, Nicolas",
"party_type": "individual",
"programs": ["VENEZUELA", "IRAN-CON-ARMS-EO"]
}
}
]
}matched responde la pregunta de sí o no en un solo campo. breakdown muestra por qué: el nombre sacó 95, y la fecha de nacimiento y el país coincidieron. Sin birth_date, el mismo nombre también devuelve a su hijo, que se llama igual, y por eso vale la pena enviar la fecha.
Ajustes#
threshold(50 a 100, por defecto85) es qué tan cerca debe estar una parte para volver. Súbelo para menos coincidencias y más cercanas; bájalo para revisar más.party_typelimita el screening aindividual,entity,vesseloaircraft.listverifica solo contrasdnonon_sdn.limit(1 a 50, por defecto10) limita las coincidencias.
Preguntas#
¿Un hits vacío significa que la persona está limpia? Significa que ninguna parte de las listas se acerca al nombre con tu umbral. Es una respuesta completa, no un error.
¿Una coincidencia es una determinación? No. Una coincidencia por nombre es un punto de partida. La propia guía de OFAC pide confirmarla contra los demás datos de la parte antes de actuar, y la lista tiene muchos nombres parecidos. Enviar la fecha de nacimiento, el país o el documento es como se distinguen.
¿Qué tan actualizado está? Las listas se ponen al día todos los días, y cada respuesta trae as_of. Es un endpoint de dataset, así que responde en milisegundos.
¿Puedo verificar toda una cartera? Llámalo una vez por persona o empresa. Un monitor sobre un screening te avisa por correo cuando su respuesta cambia tras una actualización diaria, que es como te enteras de un cliente que entró a la lista después de vincularlo.
¿Lo puede usar un agente? Sí. Está en el servidor MCP como ofac_sanctions_screen.
Cada campo está en la guía de OFAC. Para recorrer la lista por palabras está la herramienta gratuita de búsqueda OFAC, y todas las demás fuentes de Estados Unidos están en Estados Unidos.