> ## 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.
# Sanções OFAC
> As listas de sanções do Tesouro dos Estados Unidos: busque toda pessoa, empresa, embarcação e aeronave designada por nome ou alias, programa, tipo e país, e leia o registro completo de uma parte.
O Office of Foreign Assets Control, parte do Tesouro dos Estados Unidos,
publica as partes com as quais pessoas norte-americanas não podem operar. A
lista de Specially Designated Nationals and Blocked Persons é a mais
conhecida, e uma lista consolidada traz os demais programas. Cada parte vem
com todos os nomes que a OFAC lhe conhece, seus endereços, os programas sob os
quais está designada e a nota da própria OFAC, que é onde se escrevem datas e
locais de nascimento, passaportes e números tributários e de registro.
Ambas as listas, atualizadas todos os dias e pesquisáveis sobre nomes
principais e aliases ao mesmo tempo. Uma parte que a OFAC retira da lista
deixa de aparecer no mesmo dia.
A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
## Buscar partes sancionadas
`POST /us/ofac/sanctions-search/v1` Dataset
Busca em ambas as listas por qualquer combinação de nome ou alias, lista,
tipo de parte, programa de sanções e país.
| Campo | Tipo | Notas |
| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palavras do nome principal da parte ou de qualquer um dos seus aliases. Todas devem coincidir; sem stemming. |
| `list` | enum | Opcional. `sdn` para a lista de Specially Designated Nationals and Blocked Persons, `non_sdn` para a lista consolidada dos demais programas. |
| `party_type` | enum | Opcional. `individual`, `entity` para uma empresa ou organização, `vessel` ou `aircraft`. |
| `program` | string | Opcional. Código de programa de sanções, p. ex. `RUSSIA-EO14024`, `SDGT`, `CUBA`. Uma parte designada sob vários corresponde a qualquer um deles. |
| `country` | string | Opcional. País de algum dos endereços da parte, como a OFAC o escreve, p. ex. `Cuba`, `Russia`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `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" }'
```
Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `parties[]`, por nome.
Cada parte traz `id` (a chave, p. ex. `sdn-36`), `list` (`sdn` ou `non_sdn`), `entity_number`, `name` (`SOBRENOME, Nome` para uma pessoa), `party_type` (`individual`, `entity`, `vessel` ou `aircraft`), `programs[]` (os programas de sanções, p. ex. `RUSSIA-EO14024`, `SDGT`, `CUBA`), `title`, `remarks` (a nota da própria OFAC, que traz datas e locais de nascimento, passaportes e números tributários e de registro), `vessel` (indicativo, tipo, tonelagem, bandeira e proprietário, para uma embarcação), `aliases[]` (`{ type, name, remarks }`, onde o tipo é `aka`, `fka` ou `nka`), `alias_names[]`, `addresses[]` (`{ address, city_state_province, country, remarks }`) e `countries[]`.
Os campos vazios são `null`. A OFAC escreve o nome de uma pessoa começando pelo sobrenome, e registra a maior parte do detalhe identificador como texto em `remarks` e não como campos.
A busca cobre o nome principal da parte e todos os seus aliases, palavra por
palavra e sem stemming, então `query` encontra uma parte por qualquer nome que
a OFAC registre. Atualizado diariamente; uma parte que a OFAC retira da lista
deixa de aparecer.
Uma coincidência de nome é um ponto de partida, não uma determinação. A
própria OFAC recomenda confirmar um resultado com os demais identificadores da
parte antes de agir, e a lista traz muitos nomes parecidos.
## Uma parte
`POST /us/ofac/sanctioned-party/v1` Dataset
Resolve uma parte sancionada pelo seu id e retorna o registro completo.
| Campo | Tipo | Notas |
| ----- | ------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | string | **Obrigatório.** Id da parte, a lista e o número de entidade da OFAC unidos por um hífen, p. ex. `sdn-36`, como retornado pela busca. |
```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" }'
```
Retorna `found`, `id`, `as_of` e `party` (null quando não encontrado).
Cada parte traz `id` (a chave, p. ex. `sdn-36`), `list` (`sdn` ou `non_sdn`), `entity_number`, `name` (`SOBRENOME, Nome` para uma pessoa), `party_type` (`individual`, `entity`, `vessel` ou `aircraft`), `programs[]` (os programas de sanções, p. ex. `RUSSIA-EO14024`, `SDGT`, `CUBA`), `title`, `remarks` (a nota da própria OFAC, que traz datas e locais de nascimento, passaportes e números tributários e de registro), `vessel` (indicativo, tipo, tonelagem, bandeira e proprietário, para uma embarcação), `aliases[]` (`{ type, name, remarks }`, onde o tipo é `aka`, `fka` ou `nka`), `alias_names[]`, `addresses[]` (`{ address, city_state_province, country, remarks }`) e `countries[]`.
Os campos vazios são `null`. A OFAC escreve o nome de uma pessoa começando pelo sobrenome, e registra a maior parte do detalhe identificador como texto em `remarks` e não como campos.
Um id que nenhuma lista registra retorna `found: false` com HTTP 200, não um
erro. Essa é também a resposta para uma parte que a OFAC retirou da lista.
Esquemas, todos os campos de resposta e um playground interativo.