> ## 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.

# Consolidated Screening List

> Todas as listas de controle de exportações e sanções dos Estados Unidos numa só busca: as listas da OFAC do Tesouro, a Entity List, a Denied Persons List, a Unverified List e a Military End User List do Departamento de Comércio, e as sanções de não proliferação e as inabilitações ITAR do Departamento de Estado. Busque por nome ou alias, lista, agência, programa, país ou número de identificação, e leia o registro completo de uma parte.

Três agências dos Estados Unidos mantêm listas de partes com as quais pessoas
norte-americanas não podem operar, ou para as quais só podem exportar com
licença. O Office of Foreign Assets Control do Tesouro mantém as listas de
sanções, o Bureau of Industry and Security do Departamento de Comércio mantém
as listas de controle de exportações, e o Departamento de Estado mantém as
sanções de não proliferação e as partes inabilitadas para o comércio de armas.
A International Trade Administration consolida todas numa só lista, e é isso
que esta fonte serve: uma busca verifica um nome contra todas as listas ao
mesmo tempo.

Cada parte vem com todos os nomes que a lista registra, seus endereços, os
programas ou leis que sustentam a inclusão, os números de identificação que a
lista registra (números fiscais e de registro, passaportes, códigos SWIFT,
números IMO de embarcações, endereços de criptomoedas), e para as listas do
Comércio o aviso do Federal Register, a data em que a inclusão entrou em vigor
e as condições de licença. Atualizado todos os dias; uma parte que uma agência
retira da sua lista deixa de aparecer em menos de um dia.

| `list`   | Lista                                                              | Agência        |
| -------- | ------------------------------------------------------------------ | -------------- |
| `sdn`    | Specially Designated Nationals and Blocked Persons                 | Tesouro (OFAC) |
| `ssi`    | Sectoral Sanctions Identifications                                 | Tesouro (OFAC) |
| `cmic`   | Non-SDN Chinese Military-Industrial Complex Companies              | Tesouro (OFAC) |
| `ns_mbs` | Non-SDN Menu-Based Sanctions                                       | Tesouro (OFAC) |
| `plc`    | Palestinian Legislative Council                                    | Tesouro (OFAC) |
| `cap`    | Correspondent Account or Payable-Through Account Sanctions (CAPTA) | Tesouro (OFAC) |
| `fse`    | Foreign Sanctions Evaders                                          | Tesouro (OFAC) |
| `el`     | Entity List                                                        | Comércio (BIS) |
| `dpl`    | Denied Persons List                                                | Comércio (BIS) |
| `uvl`    | Unverified List                                                    | Comércio (BIS) |
| `meu`    | Military End User List                                             | Comércio (BIS) |
| `isn`    | Nonproliferation Sanctions                                         | Estado         |
| `dtc`    | ITAR Debarred                                                      | Estado         |

A Entity List também inclui alguns endereços por si sós, com nomes como
`Address 01` e o endereço em `addresses`: `list: "el"` com um `country` os
encontra.

Para as listas do Tesouro sozinhas, com as notas próprias da OFAC sobre cada
parte, use [sanções OFAC](/pt/guides/united-states/ofac).

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

## Verificar um nome

`POST /us/csl/parties-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Busca em todas as listas por qualquer combinação de nome ou alias, lista,
agência, tipo de parte, programa, país, número de identificação e data de
inclusão.

| Campo        | Tipo    | Notas                                                                                                                                                                                                                                                                                                                         |
| ------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`      | string  | Opcional. Palavras do nome da parte ou de qualquer outro nome que a lista registre. Todas devem coincidir; sem stemming.                                                                                                                                                                                                      |
| `list`       | enum    | Opcional. Uma lista, pelo código da tabela acima, p. ex. `el` para a Entity List.                                                                                                                                                                                                                                             |
| `agency`     | enum    | Opcional. `treasury` para as listas da OFAC, `commerce` para as do Bureau of Industry and Security, `state` para as do Departamento de Estado.                                                                                                                                                                                |
| `party_type` | enum    | Opcional. `individual`, `entity` para uma empresa ou organização, `vessel` ou `aircraft`. Só as listas do Tesouro registram o tipo, então este filtro deixa as demais de fora.                                                                                                                                                |
| `program`    | string  | Opcional. Um programa de sanções ou uma lei exatamente como aparece em `programs`, p. ex. `SDGT`, `RUSSIA-EO14024`, `CMIC-EO13959`, `Chemical and Biological Weapons Act`.                                                                                                                                                    |
| `country`    | string  | Opcional. Código de duas letras do país de algum dos endereços da parte, p. ex. `CN`, `RU`, `VE`.                                                                                                                                                                                                                             |
| `identifier` | string  | Opcional. Um número de identificação que a lista registra para a parte: um número fiscal como um NIT, um RFC ou um RUC, um número de registro, um passaporte, um código SWIFT, um número IMO, um endereço de criptomoeda. Comparado sem maiúsculas, espaços nem sinais, então `900.123.456-7` e `9001234567` coincidem igual. |
| `from_date`  | string  | Opcional. Data mais antiga em que a inclusão entrou em vigor, yyyy-mm-dd. Só as listas do Comércio e as sanções de não proliferação a registram, então um filtro de data deixa as demais de fora.                                                                                                                             |
| `to_date`    | string  | Opcional. Data mais recente em que a inclusão entrou em vigor, yyyy-mm-dd.                                                                                                                                                                                                                                                    |
| `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/csl/parties-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "huawei" }'
```

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), `list`, `list_name`, `agency` (`treasury`, `commerce` ou `state`), `entity_number` (o número da OFAC, numa lista do Tesouro), `name`, `alt_names[]`, `party_type` (`individual`, `entity`, `vessel` ou `aircraft`, numa lista do Tesouro), `programs[]`, `title`, `remarks`, `addresses[]` (`{ address, city, state, postal_code, country }`), `countries[]`, `identifiers[]` (`{ type, number, country, issue_date, expiration_date }`: números fiscais e de registro, passaportes, documentos de identidade, códigos SWIFT, números IMO de embarcações, endereços de criptomoedas, sites), `identifier_numbers[]`, `dates_of_birth[]`, `places_of_birth[]`, `nationalities[]`, `citizenships[]`, `federal_register_notice`, `start_date`, `end_date`, `standard_order`, `license_requirement`, `license_policy`, `vessel` (para uma embarcação), `source_list_url` e `source_information_url` (as páginas da agência sobre a lista).

Os campos vazios são `null`. Cada lista preenche o seu próprio subconjunto: as listas do Comércio e do Estado não trazem tipo de parte, e as datas, condições de licença e avisos do Federal Register vêm sobretudo delas.

<Note>
  O `id` de uma entrada numa lista do Tesouro é a lista e o número de entidade
  da OFAC (`sdn-36`), o mesmo número que os endpoints de
  [sanções OFAC](/pt/guides/united-states/ofac) usam. Numa lista do Comércio ou
  do Estado é a lista e o código próprio da entrada, que muda quando a agência
  altera a entrada: busque pelo nome de novo em vez de guardá-lo por muito
  tempo.
</Note>

<Note>
  A busca cobre o nome da parte e todos os demais nomes que a lista registra,
  palavra por palavra e sem stemming. Atualizado diariamente; uma parte que uma
  agência retira da sua lista deixa de aparecer.
</Note>

<Warning>
  Uma coincidência de nome é um ponto de partida, não uma determinação. Cada
  agência recomenda confirmar um resultado com os demais identificadores da parte
  (endereços, datas de nascimento, números de registro) antes de agir, e as
  listas trazem muitos nomes parecidos.
</Warning>

## Uma parte

`POST /us/csl/party/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Resolve uma parte pelo seu id e retorna o registro completo.

| Campo | Tipo   | Notas                                                                    |
| ----- | ------ | ------------------------------------------------------------------------ |
| `id`  | string | **Obrigatório.** Id da parte como retornado pela busca, p. ex. `sdn-36`. |

```bash theme={"dark"}
curl https://api.croma.run/us/csl/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), `list`, `list_name`, `agency` (`treasury`, `commerce` ou `state`), `entity_number` (o número da OFAC, numa lista do Tesouro), `name`, `alt_names[]`, `party_type` (`individual`, `entity`, `vessel` ou `aircraft`, numa lista do Tesouro), `programs[]`, `title`, `remarks`, `addresses[]` (`{ address, city, state, postal_code, country }`), `countries[]`, `identifiers[]` (`{ type, number, country, issue_date, expiration_date }`: números fiscais e de registro, passaportes, documentos de identidade, códigos SWIFT, números IMO de embarcações, endereços de criptomoedas, sites), `identifier_numbers[]`, `dates_of_birth[]`, `places_of_birth[]`, `nationalities[]`, `citizenships[]`, `federal_register_notice`, `start_date`, `end_date`, `standard_order`, `license_requirement`, `license_policy`, `vessel` (para uma embarcação), `source_list_url` e `source_information_url` (as páginas da agência sobre a lista).

Os campos vazios são `null`. Cada lista preenche o seu próprio subconjunto: as listas do Comércio e do Estado não trazem tipo de parte, e as datas, condições de licença e avisos do Federal Register vêm sobretudo delas.

<Note>
  O `id` de uma entrada numa lista do Tesouro é a lista e o número de entidade
  da OFAC (`sdn-36`), o mesmo número que os endpoints de
  [sanções OFAC](/pt/guides/united-states/ofac) usam. Numa lista do Comércio ou
  do Estado é a lista e o código próprio da entrada, que muda quando a agência
  altera a entrada: busque pelo nome de novo em vez de guardá-lo por muito
  tempo.
</Note>

<Note>
  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 saiu da lista.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>
