{"openapi":"3.1.0","info":{"title":"SanctionsNorth API","version":"0.1.0","description":"Sanctions screening against US, UK and Canadian lists. Pay per call in USDC via x402; no account. Screening aid only, not legal advice or a compliance determination. Results are fuzzy name matches against public sanctions lists: they can include false positives and can miss listed parties (unlisted name variants, ownership/control-based restrictions such as OFAC's 50% rule, lists not covered here). Confirm any potential match against the official list, using identifiers such as date of birth, nationality and address, before acting."},"servers":[{"url":"https://sanctionsnorth.fly.dev"}],"paths":{"/v1/screen":{"get":{"operationId":"screen","summary":"Screen one name against US, UK and Canadian sanctions lists","description":"Sanctions screening API: check one person, company or vessel name against US OFAC SDN + non-SDN, the UK Sanctions List and Canada's Consolidated Autonomous Sanctions List (SEMA / Justice for Victims of Corrupt Foreign Officials Act), 32,000+ listed parties. Fuzzy, transliteration-aware matching with scores, aliases, programs, DOB and country flags. Lists refreshed twice a day from the official sources. For KYC / AML / onboarding / payments checks. Screening aid only, not legal advice.","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","description":"Name to screen (2-200 characters)"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"person, entity, vessel or any (default any)"}},{"name":"dob","in":"query","required":false,"schema":{"type":"string","description":"Date or year of birth, e.g. 1970 or 1970-05-01 (people only; mismatches are down-ranked and flagged)"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"Country (nationality or address); mismatches are flagged"}},{"name":"lists","in":"query","required":false,"schema":{"type":"string","description":"Comma-separated subset: us_ofac_sdn, us_ofac_cons, uk_sanctions, ca_sema (default all)"}},{"name":"minScore","in":"query","required":false,"schema":{"type":"string","description":"0.70-1.00, default 0.85"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","description":"1-25 matches, default 10"}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","payTo":"0x2eE3eB1bbb97f374BAfEde3a484C5F213278ec55"},"x-x402":{"scheme":"exact","price":"$0.005","network":"eip155:8453","asset":"USDC","payTo":"0x2eE3eB1bbb97f374BAfEde3a484C5F213278ec55"},"responses":{"200":{"description":"OK (a no_match result is a valid, charged answer)","content":{"application/json":{"example":{"result":"potential_match","matchCount":3,"matches":[{"score":0.96,"strength":"strong","list":"ca_sema","listName":"Consolidated Canadian Autonomous Sanctions List","listId":"(example)","type":"entity","name":"(listed name)","matchedName":"(alias that matched)","programs":["Russia regulations, Schedule 1, Part 2"],"dob":[],"countries":["russia"],"listedOn":"2022-02-24","flags":[]}],"listsScreened":[{"id":"ca_sema","entries":5708,"fetchedAt":"2026-11-08T12:00:00Z"}],"disclaimer":"Screening aid only…"}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment required: $0.005 USDC via x402. Requirements in the PAYMENT-REQUIRED header."},"429":{"description":"Rate limited"},"503":{"description":"Lists loading after a restart (never charged)"}}}},"/v1/screen/batch":{"get":{"operationId":"screenBatch","summary":"Screen up to 25 names in one call","description":"Batch sanctions screening: check up to 25 people, companies or vessels in one call against US OFAC SDN + non-SDN, UK Sanctions List and Canada's SEMA/JVCFOA consolidated list. Names separated by '|'. Returns per-name result (potential_match / no_match) and the top matches with scores. For vendor lists, customer onboarding and payment batches. Screening aid only, not legal advice.","parameters":[{"name":"names","in":"query","required":true,"schema":{"type":"string","description":"Up to 25 names separated by '|'"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"person, entity, vessel or any (default any)"}},{"name":"dob","in":"query","required":false,"schema":{"type":"string","description":"Date or year of birth, e.g. 1970 or 1970-05-01 (people only; mismatches are down-ranked and flagged)"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"Country (nationality or address); mismatches are flagged"}},{"name":"lists","in":"query","required":false,"schema":{"type":"string","description":"Comma-separated subset: us_ofac_sdn, us_ofac_cons, uk_sanctions, ca_sema (default all)"}},{"name":"minScore","in":"query","required":false,"schema":{"type":"string","description":"0.70-1.00, default 0.85"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","description":"1-10 matches per name, default 3"}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","payTo":"0x2eE3eB1bbb97f374BAfEde3a484C5F213278ec55"},"x-x402":{"scheme":"exact","price":"$0.05","network":"eip155:8453","asset":"USDC","payTo":"0x2eE3eB1bbb97f374BAfEde3a484C5F213278ec55"},"responses":{"200":{"description":"OK (a no_match result is a valid, charged answer)","content":{"application/json":{"example":{"screened":3,"withPotentialMatches":1,"results":[{"name":"Rosneft","result":"potential_match","matchCount":2,"matches":[{"score":0.96,"strength":"strong","list":"ca_sema","listName":"Consolidated Canadian Autonomous Sanctions List","listId":"(example)","type":"entity","name":"(listed name)","matchedName":"(alias that matched)","programs":["Russia regulations, Schedule 1, Part 2"],"dob":[],"countries":["russia"],"listedOn":"2022-02-24","flags":[]}]},{"name":"Acme Widgets Inc","result":"no_match","matchCount":0,"matches":[]}]}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment required: $0.05 USDC via x402. Requirements in the PAYMENT-REQUIRED header."},"429":{"description":"Rate limited"},"503":{"description":"Lists loading after a restart (never charged)"}}}},"/demo/screen":{"get":{"operationId":"demoScreen","summary":"Free demo: top match only (10/day/IP)","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/lists":{"get":{"operationId":"lists","summary":"Free: lists covered, entry counts, fetch dates and licences","responses":{"200":{"description":"OK"}}}}}}