screen_sanctions
Screen a company or person against consolidated government sanctions lists and a politically-exposed-person dataset. RETURNS JSON with: screening_result (one of "MATCH", "POSSIBLE_MATCH", "CLEAR"), risk_level ("CRITICAL" for a confirmed match, "HIGH" for a possible match, "LOW" when clear), recommendation ("DO_NOT_PROCEED", "ENHANCED_DUE_DILIGENCE" or "PROCEED"), matches (array, each with list, matched_name, confidence as a percentage string such as "100%", type and id), pep_screening (separate PEP verdict with its own matches), sanctions_lists_checked, total_entries_screened, data_freshness (ISO timestamp of the last refresh) and screening_date. SOURCES: OFAC SDN (US Treasury), UN Security Council Consolidated List, EU Financial Sanctions List, and the UK FCDO UK Sanctions List (UKSL) — approximately 32,600 designations in total, plus roughly 1,000,000 PEP names from OpenSanctions. All lists are re-downloaded from the official government endpoints daily at 03:00 UTC. USE WHEN you must clear a counterparty before payment, onboarding, or any transaction with sanctions exposure. Called via MCP — usage is logged but not billed. For metered billing use the REST API with an API key.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | Yes | ISO 3166-1 alpha-2 country code of incorporation, residence or principal operation, uppercase. Examples: "RU", "IR", "GB", "AE". Recorded on the screening report for audit purposes; screening itself runs against every list regardless of country. | |
| threshold | No | Match confidence threshold 0.5-1.0. Default 0.75. Lower values catch more potential matches; higher values reduce false positives. MATCH requires >=0.90 regardless of threshold. | |
| entity_name | Yes | Full name of the company or individual to screen. Examples: "Rosneft", "Gazprom PJSC", "Vladimir Putin". Matching is token-based and case-insensitive, and also searches recorded aliases and a.k.a. names. | |
| entity_type | No | Whether the subject is a legal entity or a natural person. Accepts exactly "company" or "individual". Defaults to "company" when omitted. |