{"uid":"cap_6Xc_uhFJiGNM5B5W8zU0c","slug":"fin-codes-api-sanctions-screening-ced799f6","name":"Fin Codes API – Sanctions Screening","description":"Validate IBANs, BIC/SWIFT codes and local bank routing codes worldwide with one REST API. ABA, BSB, IFSC, CLABE, NCC, Canadian routing numbers and more, plus payee verification and sanctions screening.","url":"https://api.fincodesapi.com/x402/sanctions-screening?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","example":"Sadam Husein","maxLength":255,"minLength":2,"description":"Name to screen."},"type":{"enum":["INDIVIDUAL","ENTITY","VESSEL","AIRCRAFT"],"type":"string","example":"INDIVIDUAL","description":"Only match parties of this type."},"sources":{"type":"array","items":{"enum":["EU","UK","UN","OFAC_SDN","OFAC_CONS","CH","AU","CA"],"type":"string"},"example":["EU","OFAC_SDN"],"description":"Only screen against these sanctions lists. All lists by default."},"min_score":{"type":"integer","default":90,"example":90,"maximum":100,"minimum":70,"description":"Minimum match score from 70 to 100."}}},"responseSchema":{"type":"json","example":{"data":{"name":"Sadam Husein","matches":[{"id":"ef947777-8b4c-4859-b07b-042be956bf4a","name":"Saddam Hussein Al-Tikriti","type":"INDIVIDUAL","score":90,"source":"EU","programs":["IRQ"],"listed_on":"2003-07-08","birth_dates":["1937-04-28"],"matched_name":"Saddam Hussein Al-Tikriti","source_reference":"EU.27.28"}]},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YmPlkI4kWxaoEOjk4ZTZg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens an individual, entity, vessel, or aircraft name against major global sanctions lists (OFAC SDN, EU, UN, UK, CH, AU, CA) and returns fuzzy-matched hits with scores, programs, and listed dates.","exampleAgentPrompt":"Screen 'Sadam Husein' as an INDIVIDUAL against the EU and OFAC SDN sanctions lists with a minimum match score of 90 and tell me if there are any hits.","exampleUseCases":[{"title":"KYC onboarding sanctions check","prompt":"Before I onboard this new customer, screen the name 'Viktor Petrov' as an INDIVIDUAL against all available sanctions lists — flag anything with a match score of 85 or above."},{"title":"B2B counterparty compliance review","prompt":"I'm about to wire money to a company called 'Global Trade Solutions LLC' — can you run a sanctions screen against OFAC SDN and the UN list with a minimum score of 90 to make sure they're clear?"},{"title":"Vessel blacklist screening","prompt":"Check whether the vessel named 'Sea Pioneer' appears on any UK or EU sanctions lists and let me know the match score and which programs it's listed under."}],"resultDescription":"Returns a JSON object with the queried name, a list of matches (each including a UUID, the matched name, party type, fuzzy match score, the sanctions list source, applicable programs, date listed, birth dates if available, and source reference), and a success flag. An empty matches array means no hits were found.","failureModes":["Name too short (under 2 characters) or over 255 characters returns a validation error","min_score outside 70–100 range is rejected","Invalid enum value for type or sources returns a 422 validation error","Network timeout on POST may occur for very broad multi-list queries","Typos in list source codes (e.g. 'OFAC' instead of 'OFAC_SDN') return an error or empty result"],"whenToPreferThis":"Choose this endpoint when you need fuzzy-match sanctions screening across multiple authoritative global watchlists (OFAC SDN, EU, UN, UK, AU, CH, CA) in a single API call with configurable score thresholds. Prefer this over generic AML tools when you also need bank code or IBAN validation on the same platform, or when you need to screen vessels and aircraft in addition to individuals and entities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:35:22.443Z","isFirstParty":false,"canonicalSlug":"fin-codes-api-sanctions-screening-ced799f6"}