Fazer screening de sanções é verificar se um cliente, fornecedor ou contraparte está numa lista de sanções antes de fazer negócio com ele. Nos Estados Unidos a lista que importa é a da OFAC: a lista SDN (Specially Designated Nationals) do Tesouro mais as listas não SDN, cerca de 20.000 pessoas, empresas, navios e aeronaves.
A partir de hoje, POST /us/ofac/sanctions-screen/v1 recebe o nome que você tem, com o que mais souber, e devolve as partes dessas listas que podem ser a mesma. Cada uma vem com uma nota de 0 a 100 e o que a decidiu.
Por que buscar o nome não basta#
Os nomes nunca chegam como a lista os escreve. A OFAC registra MADURO MOROS, Nicolas. Seu formulário de cadastro diz Nicolás Maduro Moros. Uma busca exata não encontra nada, e em screening "nada" é a resposta errada mais cara que existe.
O screening compara nomes como um analista de compliance os lê:
- Em qualquer ordem:
Nicolas MaduroeMADURO MOROS, Nicolassão a mesma pessoa. - Com erros e transliterações:
NicholasencontraNicolas, eAero CarribeanencontraAERO CARIBBEAN. - Com ou sem acentos e pontuação:
NicoláseNicolascoincidem. - Com palavras juntas ou separadas:
Al QaidaeAlqaidacoincidem. - Os aliases também: cada nome principal e cada alias que a OFAC registra é comparado.
Ele também sabe o que não torna dois nomes parecidos. Formas societárias como LLC ou S.A. não contam, então duas empresas sem relação que compartilham o sufixo não se confundem. E dois nomes que só diferem num número, como dois navios da mesma frota, não coincidem.
Como funciona#
A nota pondera o que você envia. O nome decide a maior parte, e o resto confirma ou descarta a correspondência:
| O que você envia | Peso | O que faz |
|---|---|---|
name | 60 | Obrigatório. Comparado com erros, ordem, acentos e aliases |
birth_date | 25 | O mesmo dia soma, o mesmo ano conta em parte, outro ano subtrai |
country | 15 | Um vínculo com o país soma, nenhum subtrai. Nome em inglês ou código ISO |
id_number | decide | Um passaporte, documento ou número fiscal que coincide com um registrado pela OFAC leva a nota a 100 |
O que você não envia, ou o que a OFAC não registra para uma parte, não é comparado, e o peso dele se divide entre o resto. Só com o nome, o nome é a nota inteira.
Experimente#
curl https://api.croma.run/us/ofac/sanctions-screen/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Nicolas Maduro",
"birth_date": "1962-11-23",
"country": "VE"
}'O nome vai em outra ordem que na lista e sem o segundo sobrenome, e mesmo assim encontra a parte:
{
"as_of": "2026-10-13T21:30:34.860Z",
"threshold": 85,
"matched": true,
"count": 1,
"hits": [
{
"score": 97,
"matched_name": "MADURO MOROS, Nicolas",
"matched_on": "name",
"breakdown": {
"name": { "score": 95, "weight": 0.6 },
"birth_date": { "result": "match", "score": 100, "weight": 0.25, "value": "23 Nov 1962" },
"country": { "result": "match", "score": 100, "weight": 0.15, "value": "Venezuela" },
"id_number": { "result": "not_compared", "value": null }
},
"party": {
"id": "sdn-22790",
"list": "sdn",
"name": "MADURO MOROS, Nicolas",
"party_type": "individual",
"programs": ["VENEZUELA", "IRAN-CON-ARMS-EO"]
}
}
]
}matched responde a pergunta de sim ou não num só campo. breakdown mostra o porquê: o nome tirou 95, e a data de nascimento e o país coincidiram. Sem birth_date, o mesmo nome também devolve o filho, que tem o mesmo nome, e por isso vale a pena enviar a data.
Ajustes#
threshold(50 a 100, padrão85) é o quão perto uma parte precisa estar para voltar. Aumente para menos correspondências e mais próximas; diminua para revisar mais.party_typelimita o screening aindividual,entity,vesselouaircraft.listverifica só emsdnounon_sdn.limit(1 a 50, padrão10) limita as correspondências.
Perguntas#
Um hits vazio significa que a pessoa está limpa? Significa que nenhuma parte das listas se aproxima do nome no seu limiar. É uma resposta completa, não um erro.
Uma correspondência é uma determinação? Não. Uma correspondência por nome é um ponto de partida. A própria orientação da OFAC é confirmá-la com os outros dados da parte antes de agir, e a lista tem muitos nomes parecidos. Enviar a data de nascimento, o país ou o documento é como se distinguem.
Quão atualizado está? As listas são atualizadas todos os dias, e cada resposta traz as_of. É um endpoint de dataset, então responde em milissegundos.
Posso verificar uma carteira inteira? Chame uma vez por pessoa ou empresa. Um monitor sobre um screening avisa por e-mail quando a resposta muda após uma atualização diária, que é como você descobre um cliente que entrou na lista depois do cadastro.
Um agente pode usar? Sim. Está no servidor MCP como ofac_sanctions_screen.
Cada campo está no guia da OFAC. Para percorrer a lista por palavras há a ferramenta gratuita de busca OFAC, e todas as outras fontes dos Estados Unidos estão em Estados Unidos.