Pular para o conteúdo principal
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. Para revisar uma pessoa ou empresa, verifique-a: os nomes coincidem mesmo com erros ou em outra ordem, e cada possível coincidência traz uma pontuação e o que a definiu.
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.

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.
Retorna as_of (o quão atuais são os dados), os filtros aplicados, total e total_is_exact, 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.

Verificar uma pessoa ou empresa

POST /us/ofac/sanctions-screen/v1 Dataset Pontua cada parte de ambas as listas frente a um sujeito e retorna as que podem ser o mesmo, da mais próxima à menos. Envie o que souber: o nome define a maior parte da pontuação, e uma data de nascimento, um país ou um número de identificação confirmam ou descartam um resultado.
Retorna as_of (o quão atuais são os dados), a query como foi entendida, o threshold, matched (se alguma parte o alcançou), count e hits[], da mais próxima à menos. Cada resultado traz score (de 0 a 100), matched_name (o nome principal ou alias que melhor coincidiu, como a OFAC o escreve), matched_on (name ou alias), breakdown e party, o registro completo como a busca o retorna. breakdown diz o que definiu a pontuação: name (score, weight), birth_date e country (result, score, weight, value), e id_number (result, value). Um result é match, partial (uma data de nascimento do mesmo ano, outro dia), mismatch ou not_compared, e value é o que a OFAC registra.
A pontuação pondera o nome em 60, a data de nascimento em 25 e o país em 15. Uma parte que a solicitação não traz, ou que a OFAC não registra para a parte, não é comparada, e as demais dividem o seu peso: só com o nome, o nome é toda a pontuação. Uma data de nascimento de outro ano subtrai, assim como um país com o qual a parte não tem relação. Um número de identificação que coincide com um que a OFAC registra leva a pontuação a 100.
Os nomes coincidem em qualquer ordem, com ou sem acentos, com erros de digitação e com palavras unidas ou separadas. Formas jurídicas como LLC ou S.A. não tornam duas empresas parecidas, e nomes cujos números diferem, como duas embarcações, não coincidem. Um nome de uma só palavra é comparado inteiro, então verifique com o nome completo. As partes abaixo de threshold não são retornadas, então um hits vazio é a resposta “nenhuma parte das listas se aproxima”, não um erro.
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.
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.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.