# OFAC Sanctions Screening & Export (`straightforward_hydra/ofac-sanctions-screening`) Actor Screen names against the US OFAC sanctions lists (SDN + Consolidated) with alias-aware fuzzy matching, or export the full lists as structured data. Official public-domain data, no API key. - **URL**: https://apify.com/straightforward\_hydra/ofac-sanctions-screening.md - **Developed by:** [Dev D](https://apify.com/straightforward_hydra) (community) - **Categories:** Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## OFAC Sanctions Screening & Export ๐Ÿ›ก๏ธ **Screen names against the US OFAC sanctions lists โ€” or export the full lists as clean structured data. Official public-domain data, no API key.** Sanctions screening is a mandatory compliance step for banks, fintechs, crypto exchanges and marketplaces. This Actor checks a list of names (people or entities) against the **OFAC SDN** and **Consolidated** sanctions lists using alias-aware fuzzy matching, and flags potential hits with a match score. It can also export the full lists as structured records for your own systems. > Uses the official **US Treasury OFAC** published lists โ€” public-domain government data, freely redistributable. **No API key needed.** โš ๏ธ **This is an informational screening tool against public lists, not a certified compliance solution.** Always confirm potential matches through your own compliance process. --- ### What you can do with it - ๐Ÿ›ก๏ธ **KYC / onboarding checks** โ€” screen customers, vendors and counterparties. - ๐Ÿ” **Batch screening** โ€” check thousands of names in one run. - ๐Ÿงพ **Compliance feeds** โ€” export the current sanctions lists into your database. - ๐Ÿ”” **Ongoing monitoring** โ€” re-screen your customer list on a schedule as the lists change. ### Features - โœ… **No API key** โ€” official OFAC data, works out of the box. - โœ… **Alias-aware fuzzy matching** โ€” catches near-matches and a.k.a. names, with a tunable threshold. - โœ… **SDN + Consolidated lists** โ€” the two core US sanctions lists. - โœ… **Screen and Export modes** โ€” check your names, or dump the lists. - โœ… **Rich records** โ€” programs, aliases, nationalities, dates of birth, IDs, addresses. --- ### Modes #### Screen Provide a list of **names**; get one result row per name showing whether it matched, how many matches, the best score, and the matched entries. ```json { "mode": "screen", "names": ["Vladimir Putin", "John A. Smith", "Acme Trading LLC"], "matchThreshold": "0.85" } ```` #### Export Dump the sanctions lists, optionally filtered by name, program or entity type. ```json { "mode": "export", "lists": ["SDN"], "program": "CUBA", "entityType": "Entity" } ``` ### Input | Field | Description | |---|---| | **Mode** | `screen` or `export`. | | **Names to screen** | Names to check (screen mode). | | **Sanctions lists** | SDN and/or Consolidated. | | **Match threshold** | 0.5โ€“1.0; higher = stricter. Default 0.85. | | **Name contains / Program / Entity type** | Export-mode filters. | | **Max results** | Cap the output. | ### Output **Screen mode** โ€” one row per screened name: ```json { "query_name": "Vladimir Putin", "is_match": true, "match_count": 1, "best_score": 1.0, "top_match_name": "Vladimir Vladimirovich PUTIN", "top_match_type": "Individual", "top_match_source": "SDN", "top_match_programs": ["UKRAINE-EO13661"], "matches": [ {"matched_name": "Vladimir Vladimirovich PUTIN", "score": 1.0, "type": "Individual", "source": "SDN", "programs": ["UKRAINE-EO13661"], "uid": "...", "aliases": ["..."], "nationalities": ["Russia"], "dates_of_birth": ["07 Oct 1952"]} ] } ``` **Export mode** โ€” one row per sanctioned entry (uid, name, type, source, programs, aliases, addresses, nationalities, dates\_of\_birth, ids, remarks). ### Run it on a schedule The OFAC lists change frequently. Schedule the Actor to re-screen your customer list regularly, and connect a **Slack / email / webhook** integration to alert your compliance team on new hits. ### Notes & limitations - Uses official US Treasury OFAC data (SDN + Consolidated). Public-domain. - Matching is name-based and alias-aware; tune `matchThreshold` to trade off false positives vs. misses. - Covers **US OFAC** lists. UN / EU / UK lists can be added on request. - **Informational only** โ€” not legal advice or a certified screening solution. Verify hits through your compliance process. *** #### Keywords OFAC sanctions, sanctions screening, SDN list, sanctions list, KYC, AML, compliance, denied party screening, watchlist screening, sanctions check, Specially Designated Nationals, sanctions API, name screening, PEP, due diligence, sanctions data, Treasury sanctions, sanctions search, compliance screening, fintech compliance. # Actor input Schema ## `mode` (type: `string`): Screen = check your names against the lists and return matches. Export = dump the sanctions lists as structured records. ## `names` (type: `array`): The names (people or entities) to check against the sanctions lists. Used in Screen mode. ## `lists` (type: `array`): Which OFAC lists to use. SDN is the main Specially Designated Nationals list; Consolidated covers additional non-SDN sanctions. ## `matchThreshold` (type: `string`): How close a name must match to count as a hit, 0.5โ€“1.0. Higher = stricter (fewer false positives). 0.85 is a good default; 1.0 = exact only. ## `nameContains` (type: `string`): Export mode: only include entries whose name or alias contains this text. ## `program` (type: `string`): Export mode: only include entries under this program code, e.g. UKRAINE-EO13662, IRAN, SDGT, CUBA. ## `entityType` (type: `string`): Export mode: filter by type. ## `maxResults` (type: `integer`): Stop after this many results. Leave empty for no limit. ## Actor input object example ```json { "mode": "screen", "names": [ "Vladimir Putin", "John A. Smith" ], "lists": [ "SDN", "Consolidated" ], "matchThreshold": "0.85", "entityType": "" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "names": [ "Vladimir Putin", "John A. Smith" ] }; // Run the Actor and wait for it to finish const run = await client.actor("straightforward_hydra/ofac-sanctions-screening").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "names": [ "Vladimir Putin", "John A. Smith", ] } # Run the Actor and wait for it to finish run = client.actor("straightforward_hydra/ofac-sanctions-screening").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "names": [ "Vladimir Putin", "John A. Smith" ] }' | apify call straightforward_hydra/ofac-sanctions-screening --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=straightforward_hydra/ofac-sanctions-screening", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OFAC Sanctions Screening & Export", "description": "Screen names against the US OFAC sanctions lists (SDN + Consolidated) with alias-aware fuzzy matching, or export the full lists as structured data. Official public-domain data, no API key.", "version": "0.1", "x-build-id": "Slc7ELITbzcaQxR3c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/straightforward_hydra~ofac-sanctions-screening/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-straightforward_hydra-ofac-sanctions-screening", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/straightforward_hydra~ofac-sanctions-screening/runs": { "post": { "operationId": "runs-sync-straightforward_hydra-ofac-sanctions-screening", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/straightforward_hydra~ofac-sanctions-screening/run-sync": { "post": { "operationId": "run-sync-straightforward_hydra-ofac-sanctions-screening", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "screen", "export" ], "type": "string", "description": "Screen = check your names against the lists and return matches. Export = dump the sanctions lists as structured records.", "default": "screen" }, "names": { "title": "Names to screen", "type": "array", "description": "The names (people or entities) to check against the sanctions lists. Used in Screen mode.", "items": { "type": "string" } }, "lists": { "title": "Sanctions lists", "type": "array", "description": "Which OFAC lists to use. SDN is the main Specially Designated Nationals list; Consolidated covers additional non-SDN sanctions.", "items": { "type": "string", "enum": [ "SDN", "Consolidated" ], "enumTitles": [ "SDN (Specially Designated Nationals)", "Consolidated (non-SDN)" ] }, "default": [ "SDN", "Consolidated" ] }, "matchThreshold": { "title": "Match threshold", "type": "string", "description": "How close a name must match to count as a hit, 0.5โ€“1.0. Higher = stricter (fewer false positives). 0.85 is a good default; 1.0 = exact only.", "default": "0.85" }, "nameContains": { "title": "Name contains (export)", "type": "string", "description": "Export mode: only include entries whose name or alias contains this text." }, "program": { "title": "Sanctions program (export)", "type": "string", "description": "Export mode: only include entries under this program code, e.g. UKRAINE-EO13662, IRAN, SDGT, CUBA." }, "entityType": { "title": "Entity type (export)", "enum": [ "", "Individual", "Entity", "Vessel", "Aircraft" ], "type": "string", "description": "Export mode: filter by type.", "default": "" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many results. Leave empty for no limit." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```