{"uid":"cap_ba0YCYTV_f4NsdYcmngt1","slug":"scan-madhousewallet-com-05810d28","name":"OpenSanctions Entity Screening API","description":"Screen any person, company, or entity against OpenSanctions -- 1.3M+ entries from OFAC SDN, EU Sanctions, UN List, and 330+ sources. Returns sanctioned: true/false, entity type, risk topics (sanction, debarment, role.pep), and source datasets. Optional: country (ISO-2), address, birthDate narrow false positives. For AML/KYC pre-screening and off-ramp compliance. Pay with USDC on Base, Polygon, or Arbitrum.","url":"https://scan.madhousewallet.com/api/public/sanctions-check?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Full name of the person, company, or entity to screen. Required."},"address":{"type":"string","description":"Optional free-text address. Used for token-overlap disambiguation -- requires at least 2 strong tokens (length >= 3) to match a sanctioned address string."},"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2 country code (e.g. US, RU, CN). Narrows results when both the query and the matched entity have a country. Skipped if either side lacks country data."},"birthDate":{"type":"string","description":"Optional birth date: YYYY or YYYY-MM-DD. Partial dates work (1967 matches 1967-01-13). Skipped if either side lacks birth date data."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["sanctioned","name","matchCount","matches"],"properties":{"name":{"type":"string","description":"The name as submitted."},"matches":{"type":"array","description":"All entities that passed the applied filters. Each entry has entityId, caption, entityType, topics, matchedOn, and datasets. Empty when sanctioned: false."},"matchCount":{"type":"number","description":"Number of distinct entities that passed all filters. Common names without country/birthDate may return multiple matches."},"sanctioned":{"type":"boolean","description":"True when one or more entities matched all applied filters. False means clean."}}}}}}},"responseSchema":{"type":"json","example":{"name":"Viktor Bout","matches":[{"topics":["role.pep","sanction","debarment"],"caption":"Viktor Anatolijevitch BOUT","datasets":["us_ofac_sdn","us_trade_csl","eu_financial_sanctions_files"],"entityId":"Q314650","matchedOn":["name","country","birthDate"],"entityType":"Person"}],"matchCount":1,"sanctioned":true}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"name":"John Smith","country":"US"}}},"response":{"name":"John Smith","matches":[{"topics":["role.pep","poi"],"caption":"Jack Smith","datasets":["wd_categories","ann_pep_positions","wikidata"],"entityId":"Q115271256","countries":["us","zz"],"matchedOn":["name","country"],"entityType":"Person"},{"topics":["role.pol","role.pep"],"caption":"John R. Smith","datasets":["wd_categories","wikidata","ann_pep_positions","wd_peps"],"entityId":"Q6254008","countries":["us"],"matchedOn":["name","country"],"entityType":"Person"},{"topics":["role.pol","role.pep"],"caption":"John Robert Smith","datasets":["wd_categories","wikidata"],"entityId":"Q6255146","countries":["us"],"matchedOn":["name","country"],"entityType":"Person"},{"topics":["role.pol","role.pep"],"caption":"John Smith","datasets":["wd_categories","wikidata","ann_pep_positions","wd_peps"],"entityId":"Q6258298","countries":["us"],"matchedOn":["name","country"],"entityType":"Person"}],"matchCount":4,"sanctioned":true}},"exampleRequest":{"name":"John Smith","country":"US"},"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jGJrNwFTONGMjLjchubSJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens any person, company, or entity against 1.3M+ entries from OFAC SDN, EU Sanctions, UN List, and 330+ sources to determine sanctions/PEP status for AML/KYC compliance","exampleAgentPrompt":"Can you run a sanctions check on 'Viktor Petrov', born 1967, from Russia — I need to know if he appears on OFAC, EU, or any other major sanctions list before we proceed with an off-ramp transaction?","exampleUseCases":[{"title":"Verify counterparty before wire transfer","prompt":"I'm about to send a large wire to a company called Acme Trading LLC based in Dubai. Can you quickly screen them against OFAC and other sanctions lists to make sure we're not violating any compliance rules?"},{"title":"KYC screening for new crypto customer","prompt":"We just got a signup from someone claiming to be from Turkey. Run a full sanctions check on 'Mehmet Yilmaz', born 1985, against all the major lists — I want to make sure they're not a PEP or on any watchlists before we onboard them."},{"title":"Debarment check on business partner","prompt":"Before we sign this distribution agreement with a company in Singapore, can you check if their CEO 'Raj Kumar' shows up as debarred or sanctioned anywhere? I need to verify their clean status for our records."}],"resultDescription":"Returns a JSON object with: sanctioned (true/false boolean), the submitted name, matchCount (number of distinct matched entities), and a matches array where each entry contains entityId, caption, entityType, risk topics (e.g. sanction, debarment, role.pep), matchedOn fields, and source datasets. Empty matches array means clean result.","failureModes":["Missing required 'name' parameter returns 400 error","Common names without country/birthDate may return multiple matches causing ambiguity","Payment failure if USDC balance insufficient on Base/Polygon/Arbitrum","False positives for common names when no disambiguation parameters provided","Entity not found in database returns sanctioned: false with empty matches array"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive sanctions and PEP check against 330+ global sources including OFAC SDN, EU Sanctions, and UN List in a single call. Ideal for AML/KYC pre-screening, crypto off-ramp compliance, or due diligence workflows. Prefer over individual list checks when you need broad multi-jurisdictional coverage. Use birthDate and country parameters to reduce false positives for common names.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-06-09T11:07:15.427Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:32:43.037Z","isFirstParty":false,"canonicalSlug":"scan-madhousewallet-com-05810d28"}