La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye
as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.Buscar partes sancionadas
POST /us/ofac/sanctions-search/v1 Dataset
Busca en ambas listas por cualquier combinación de nombre o alias, lista,
tipo de parte, programa de sanciones y país.
as_of (qué tan actualizados están los datos), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y parties[], por nombre.
Cada parte incluye id (la clave, p. ej. sdn-36), list (sdn o non_sdn), entity_number, name (APELLIDO, Nombre para una persona), party_type (individual, entity, vessel o aircraft), programs[] (los programas de sanciones, p. ej. RUSSIA-EO14024, SDGT, CUBA), title, remarks (la nota de la propia OFAC, que trae fechas y lugares de nacimiento, pasaportes y números tributarios y de registro), vessel (indicativo, tipo, tonelaje, bandera y propietario, para un buque), aliases[] ({ type, name, remarks }, donde el tipo es aka, fka o nka), alias_names[], addresses[] ({ address, city_state_province, country, remarks }) y countries[].
Los campos vacíos son null. La OFAC escribe el nombre de una persona empezando por el apellido, y registra la mayor parte del detalle identificatorio como texto en remarks y no como campos.
La búsqueda cubre el nombre principal de la parte y todos sus alias, palabra
por palabra y sin lematización, así que
query encuentra a una parte por
cualquier nombre que la OFAC registre. Se actualiza a diario; una parte que la
OFAC quita de la lista deja de aparecer.Verificar una persona o empresa
POST /us/ofac/sanctions-screen/v1 Dataset
Puntúa cada parte de ambas listas frente a un sujeto y devuelve las que
pueden ser el mismo, de la más cercana a la menos. Envía lo que sepas: el
nombre define la mayor parte del puntaje, y una fecha de nacimiento, un país o
un número de identificación confirman o descartan un resultado.
as_of (qué tan actualizados están los datos), la query tal como se entendió, el threshold, matched (si alguna parte lo alcanzó), count y hits[], de la más cercana a la menos.
Cada resultado incluye score (de 0 a 100), matched_name (el nombre principal o alias que mejor coincidió, tal como lo escribe la OFAC), matched_on (name o alias), breakdown y party, el registro completo tal como lo devuelve la búsqueda.
breakdown dice qué definió el puntaje: name (score, weight), birth_date y country (result, score, weight, value), e id_number (result, value). Un result es match, partial (una fecha de nacimiento del mismo año, otro día), mismatch o not_compared, y value es lo que registra la OFAC.
El puntaje pondera el nombre en 60, la fecha de nacimiento en 25 y el país en
15. Una parte que la solicitud no trae, o que la OFAC no registra para la
parte, no se compara, y las demás se reparten su peso: con solo el nombre, el
nombre es todo el puntaje. Una fecha de nacimiento de otro año resta, igual
que un país con el que la parte no tiene relación. Un número de identificación
que coincide con uno que registra la OFAC lleva el puntaje a 100.
Los nombres coinciden en cualquier orden, con o sin tildes, con errores de
tipeo y con palabras unidas o separadas. Las formas jurídicas como
LLC o
S.A. no hacen parecidas a dos empresas, y los nombres cuyos números
difieren, como dos buques, no coinciden. Un nombre de una sola palabra se
compara completo, así que verifica con el nombre completo. Las partes por
debajo de threshold no se devuelven, así que un hits vacío es la
respuesta “ninguna parte de las listas se acerca”, no un error.Una parte
POST /us/ofac/sanctioned-party/v1 Dataset
Resuelve una parte sancionada por su id y devuelve el registro completo.
found, id, as_of y party (null cuando no se encuentra).
Cada parte incluye id (la clave, p. ej. sdn-36), list (sdn o non_sdn), entity_number, name (APELLIDO, Nombre para una persona), party_type (individual, entity, vessel o aircraft), programs[] (los programas de sanciones, p. ej. RUSSIA-EO14024, SDGT, CUBA), title, remarks (la nota de la propia OFAC, que trae fechas y lugares de nacimiento, pasaportes y números tributarios y de registro), vessel (indicativo, tipo, tonelaje, bandera y propietario, para un buque), aliases[] ({ type, name, remarks }, donde el tipo es aka, fka o nka), alias_names[], addresses[] ({ address, city_state_province, country, remarks }) y countries[].
Los campos vacíos son null. La OFAC escribe el nombre de una persona empezando por el apellido, y registra la mayor parte del detalle identificatorio como texto en remarks y no como campos.
Un id que ninguna lista registra devuelve
found: false con HTTP 200, no un
error. Esa es también la respuesta para una parte que la OFAC quitó de la lista.Referencia completa
Esquemas, todos los campos de respuesta y un playground interactivo.