> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sanciones OFAC

> Las listas de sanciones del Tesoro de Estados Unidos: busca toda persona, empresa, buque y aeronave designada por nombre o alias, programa, tipo y país, y lee el registro completo de una parte.

La Office of Foreign Assets Control, parte del Tesoro de Estados Unidos,
publica las partes con las que las personas estadounidenses no pueden operar.
La lista de Specially Designated Nationals and Blocked Persons es la más
conocida, y una lista consolidada trae los demás programas. Cada parte viene
con todos los nombres que la OFAC le conoce, sus direcciones, los programas
bajo los que está designada y la nota de la propia OFAC, que es donde se
escriben fechas y lugares de nacimiento, pasaportes y números tributarios y de
registro.

Ambas listas, actualizadas cada día y buscables sobre nombres principales y
alias a la vez. Una parte que la OFAC quita de la lista deja de aparecer ese
mismo día.

<Note>
  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](/es/datasets).
</Note>

## Buscar partes sancionadas

`POST /us/ofac/sanctions-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Busca en ambas listas por cualquier combinación de nombre o alias, lista,
tipo de parte, programa de sanciones y país.

| Campo        | Tipo    | Notas                                                                                                                                            |
| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `query`      | string  | Opcional. Palabras del nombre principal de la parte o de cualquiera de sus alias. Todas deben coincidir; sin lematización.                       |
| `list`       | enum    | Opcional. `sdn` para la lista de Specially Designated Nationals and Blocked Persons, `non_sdn` para la lista consolidada de los demás programas. |
| `party_type` | enum    | Opcional. `individual`, `entity` para una empresa u organización, `vessel` o `aircraft`.                                                         |
| `program`    | string  | Opcional. Código de programa de sanciones, p. ej. `RUSSIA-EO14024`, `SDGT`, `CUBA`. Una parte designada bajo varios coincide con cualquiera.     |
| `country`    | string  | Opcional. País de alguna de las direcciones de la parte, tal como lo escribe la OFAC, p. ej. `Cuba`, `Russia`.                                   |
| `page`       | integer | Opcional. Página, empieza en 1. Por defecto `1`.                                                                                                 |
| `per_page`   | integer | Opcional. Resultados por página, 1-50. Por defecto `20`.                                                                                         |

```bash theme={"dark"}
curl https://api.croma.run/us/ofac/sanctions-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "aerocaribbean" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` (coincidencias en todas las páginas), `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.

<Note>
  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.
</Note>

<Warning>
  Una coincidencia de nombre es un punto de partida, no una determinación. La
  propia OFAC recomienda confirmar un resultado contra los demás identificadores
  de la parte antes de actuar, y la lista trae muchos nombres parecidos.
</Warning>

## Una parte

`POST /us/ofac/sanctioned-party/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Resuelve una parte sancionada por su id y devuelve el registro completo.

| Campo | Tipo   | Notas                                                                                                                                           |
| ----- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`  | string | **Obligatorio.** Id de la parte, la lista y el número de entidad de la OFAC unidos por un guion, p. ej. `sdn-36`, como lo devuelve la búsqueda. |

```bash theme={"dark"}
curl https://api.croma.run/us/ofac/sanctioned-party/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "sdn-36" }'
```

Devuelve `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.

<Note>
  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.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>