{"uid":"cap_N204K9Ak24hkM0Eg5Pb5j","slug":"oneshot-agent-api-person-sanctions-lookup-e4aedffe","name":"OneShot Agent API – Person Sanctions Lookup","description":"Entries on the US Treasury's list of Specially Designated Nationals that match a person name, each with a score, the name that matched and the entry as the list publishes it. A screening aid, not a legal determination. No match means no entry on the lists named scored at or above the minimum; it does not mean the party is clear.","url":"https://win.oneshotagent.com/v1/tools/lookup/person-sanctions?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","description":"The person name to check, 2 to 200 characters, free text. Word order, accents and punctuation do not matter"},"limit":{"type":"number","description":"Most matches to return, highest score first (1-25, default 10). total counts all matches at or above min_score"},"min_score":{"type":"number","description":"The lowest score of a match to return, 0.5 to 1 (default 0.85). 1 is the same words in any order; lower scores are spelling variants, a missing or extra middle name and an initial"}}},"responseSchema":{"type":"json","example":{"lists":[{"name":"US Treasury list of Specially Designated Nationals","as_of":"2026-10-13T00:00:00.000Z"}],"total":1,"matches":[{"entry":{"name":"PUTIN, Vladimir Vladimirovich","title":"President of the Russian Federation","number":"35096","remarks":"DOB 07 Oct 1952; Gender Male","programs":["RUSSIA-EO14024"],"addresses":[],"other_names":[{"kind":"aka","name":"PUTIN, Vladimir"}]},"score":1,"matched_name":"PUTIN, Vladimir"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kdT7M8-tvlvqKCRtRmoIW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks a person's name against sanctions lists (e.g. US Treasury SDN) and returns scored matches with entry details","exampleAgentPrompt":"Can you run a sanctions check on 'Vladimir Putin' against the OFAC list and return up to 5 matches with a minimum score of 0.9?","exampleUseCases":[{"title":"KYC onboarding compliance screen","prompt":"Before I onboard this new client, can you check if 'Ali Hassan Al-Rashid' is on any sanctions list? Return up to 10 matches with a score of at least 0.85 so I can review them."},{"title":"Investor due diligence check","prompt":"I'm about to close a deal with a guy named 'Sergei Mikhailov' — can you screen his name against OFAC sanctions lists and show me the top 3 closest matches?"},{"title":"Automated watchlist screening pipeline","prompt":"Screen the name 'Kim Jong Un' against sanctions databases and give me any matches with a score of 0.9 or higher, including their programs and aliases."}],"resultDescription":"Returns a JSON object with: the sanctions lists queried (name and as-of date), total count of all matches at or above the minimum score, and an array of top matches each containing a match score, the matched name variant, and the full entry (canonical name, title, SDN number, remarks, programs, addresses, and known aliases/AKAs).","failureModes":["Name string too short (<2 chars) or too long (>200 chars) returns validation error","min_score outside 0.5–1.0 range returns validation error","limit outside 1–25 range returns validation error","No matches found returns empty matches array with total 0","Network timeout or upstream sanctions database unavailability","Payment failure via x402 if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need a pay-per-call, no-API-key sanctions screening tool for individual persons, especially when integrating into an autonomous agent workflow that requires AML/KYC compliance checks. Prefer it over full KYC platforms when you only need name-based sanctions lookup without document verification, and over free datasets when you need a maintained, scored fuzzy-matching service with up-to-date SDN data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T16:00:50.672Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-person-sanctions-lookup-e4aedffe"}