> ## 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.
# OFAC Sanctions
> The US Treasury's sanctions lists: search every designated person, company, vessel and aircraft by name or alias, program, type and country, and read one party's full record.
The Office of Foreign Assets Control, part of the US Treasury, publishes the
parties that US persons may not deal with. The Specially Designated Nationals
and Blocked Persons list is the well-known one, and a consolidated list
carries the other programs. Each party comes with every name OFAC knows it
by, its addresses, the programs it is designated under, and OFAC's own note,
which is where dates and places of birth, passport, tax and registration
numbers are written.
Both lists, brought up to date every day and searchable across primary names
and aliases at once. A party OFAC delists stops matching the same day.
The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](/datasets).
## Search sanctioned parties
`POST /us/ofac/sanctions-search/v1` Dataset
Searches both lists by any combination of name or alias, list, party type,
sanctions program and country.
| Field | Type | Notes |
| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional. Words in the party's primary name or any of its aliases. Every word must match; no stemming. |
| `list` | enum | Optional. `sdn` for the Specially Designated Nationals and Blocked Persons list, `non_sdn` for the consolidated list of the other programs. |
| `party_type` | enum | Optional. `individual`, `entity` for a company or organisation, `vessel` or `aircraft`. |
| `program` | string | Optional. A sanctions program code, e.g. `RUSSIA-EO14024`, `SDGT`, `CUBA`. A party designated under several matches any of them. |
| `country` | string | Optional. Country of one of the party's addresses, as OFAC writes it, e.g. `Cuba`, `Russia`. |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-50. Default `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" }'
```
Returns `as_of` (how current the data is), the applied filters, `total` (matches across every page), `page`, `per_page`, `total_pages`, `count` and `parties[]`, by name.
Every party carries `id` (the key, e.g. `sdn-36`), `list` (`sdn` or `non_sdn`), `entity_number`, `name` (`LAST, First` for a person), `party_type` (`individual`, `entity`, `vessel` or `aircraft`), `programs[]` (the sanctions programs, e.g. `RUSSIA-EO14024`, `SDGT`, `CUBA`), `title`, `remarks` (OFAC's own note, which carries dates and places of birth, passport, tax and registration numbers), `vessel` (call sign, type, tonnage, flag and owner, for a vessel), `aliases[]` (`{ type, name, remarks }`, where the type is `aka`, `fka` or `nka`), `alias_names[]`, `addresses[]` (`{ address, city_state_province, country, remarks }`) and `countries[]`.
Empty fields are `null`. OFAC writes a person's name last name first, and records most identifying detail as prose in `remarks` rather than as fields.
The search matches the party's primary name and every alias, word by word
and without stemming, so `query` finds a party under any name OFAC records
for it. Brought up to date daily; a party OFAC delists stops matching.
A name match is a starting point, not a determination. OFAC's own guidance is
to confirm a hit against the party's other identifiers before acting on it,
and the list carries many similar names.
## One party
`POST /us/ofac/sanctioned-party/v1` Dataset
Resolves one sanctioned party by its id and returns the full record.
| Field | Type | Notes |
| ----- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| `id` | string | **Required.** The party's id, the list and OFAC's entity number joined by a hyphen, e.g. `sdn-36`, as returned by the search. |
```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" }'
```
Returns `found`, `id`, `as_of` and `party` (null when not found).
Every party carries `id` (the key, e.g. `sdn-36`), `list` (`sdn` or `non_sdn`), `entity_number`, `name` (`LAST, First` for a person), `party_type` (`individual`, `entity`, `vessel` or `aircraft`), `programs[]` (the sanctions programs, e.g. `RUSSIA-EO14024`, `SDGT`, `CUBA`), `title`, `remarks` (OFAC's own note, which carries dates and places of birth, passport, tax and registration numbers), `vessel` (call sign, type, tonnage, flag and owner, for a vessel), `aliases[]` (`{ type, name, remarks }`, where the type is `aka`, `fka` or `nka`), `alias_names[]`, `addresses[]` (`{ address, city_state_province, country, remarks }`) and `countries[]`.
Empty fields are `null`. OFAC writes a person's name last name first, and records most identifying detail as prose in `remarks` rather than as fields.
An id no list carries returns `found: false` with HTTP 200, not an error.
That is also the answer for a party OFAC has delisted.
Schemas, all response fields, and an interactive playground.