# Sanctions Delta Monitor — OFAC, UK OFSI & UN Change Alerts (`nexgendata/sanctions-watchlist-delta-monitor`) Actor - **URL**: https://apify.com/nexgendata/sanctions-watchlist-delta-monitor.md - **Developed by:** [NexGenData](https://apify.com/nexgendata) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $300.00 / 1,000 sanctions changes 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Sanctions & Watchlist Delta Monitor — OFAC, UK OFSI & UN Change Alerts Monitor official sanctions lists for new and changed entities across OFAC, UK OFSI, and the UN Security Council Consolidated List. This Actor snapshots each list and emits only the changes since the previous run, making it useful for recurring KYC, AML, trade-compliance, and supplier-risk monitoring. ### 1. What this Actor does On each run it fetches the selected official lists, canonicalizes every entity, compares against a stored snapshot, and (in delta mode) emits only what changed. Built for scheduled, recurring screening — not one-time downloads. ### 2. Who this is for KYC/AML teams, trade-compliance and export-control teams, fintechs and payment providers, marketplaces, banks, and vendor/supplier onboarding teams. ### 3. Recommended setup **Run once in `full` mode (optionally with a `watchlist`) to create your baseline, then schedule daily `delta` runs to receive only new and changed entries.** The first delta run per list records a baseline and emits nothing (expected, not an error); every run after that emits only changes. ### 4. Lists covered (v1) - `ofac` — US Treasury **OFAC SDN** list - `uk` — **UK OFSI** Consolidated List of financial sanctions targets - `un` — **UN Security Council** Consolidated List If one list is temporarily unavailable, the run still processes the others and logs a clear partial-results warning — one source never fails the whole run. *Planned (not yet live): Interpol Red Notices, World Bank debarment list, and the EU consolidated list. These are not included in the current version.* ### 5. Change types `added`, `removed`, `amended`, `program_changed`, `alias_changed`, `address_changed`, `identifier_changed`. Each row carries a headline `change_type` plus a `changes` array listing every dimension that changed. ### 6. Watchlist mode Pass a `watchlist` of names to monitor only the parties you care about (matched on name and aliases as whole-word phrases; enable `fuzzy` for near-spellings). Leave it empty to monitor the entire list. ### 7. Input options | Field | Default | Notes | |---|---|---| | `lists` | `["ofac","un","uk"]` | Which lists to monitor | | `mode` | `delta` | `delta` (changes only) or `full` (all current) | | `watchlist` | `[]` | Only emit matching names; empty = whole list | | `fuzzy` | `false` | Near-spelling matching (opt-in) | | `include_raw` | `false` | Attach the raw parsed record | | `max_emit` | `10000` | Safety cap on rows per run | ### 8. Output fields `list, change_type, changes, entity_name, entity_type, aliases, program, ids, addresses, nationalities, source_url, matched_watch, snapshot_date` (plus `raw` when `include_raw` is true). ### 9. Example input ```json { "lists": ["ofac", "uk", "un"], "mode": "delta", "watchlist": ["Acme Trading LLC", "John Q. Public"] } ```` ### 10. Related NexGenData Actors Part of the NexGenData compliance suite — pairs with company-registry, KYB, and beneficial-ownership Actors for end-to-end screening. ### 11. Limitations and legal disclaimer This Actor is an **alerting and filtering tool, not legal or compliance advice**. A match or change is a signal to review, not a determination. Always confirm against the official source register and follow your organization's compliance procedures. Sanctions data reflects what the upstream authorities publish; coverage and timing follow their update cadence. # Actor input Schema ## `lists` (type: `array`): Which official lists to monitor: ofac (US Treasury SDN), un (UN Security Council), uk (UK OFSI). ## `mode` (type: `string`): delta = only what changed since the last run (first run per list creates a baseline). full = all current entries. ## `watchlist` (type: `array`): Only emit entities whose name or alias matches one of these names. Empty = monitor the entire list. ## `fuzzy` (type: `boolean`): Also match near-spellings of watchlist names (opt-in). ## `since` (type: `string`): ISO date. Reserved for date-scoped queries. ## `include_raw` (type: `boolean`): Attach the raw parsed source record to each output row. ## `max_emit` (type: `integer`): Safety cap on rows per run (mainly relevant to full mode without a watchlist). ## Actor input object example ```json { "lists": [ "ofac", "un", "uk" ], "mode": "delta", "watchlist": [], "fuzzy": false, "include_raw": false, "max_emit": 10000 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/sanctions-watchlist-delta-monitor").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 = {} # Run the Actor and wait for it to finish run = client.actor("nexgendata/sanctions-watchlist-delta-monitor").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 '{}' | apify call nexgendata/sanctions-watchlist-delta-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgendata/sanctions-watchlist-delta-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sanctions Delta Monitor — OFAC, UK OFSI & UN Change Alerts", "version": "0.0", "x-build-id": "JzJBfEN4iw0bEf1ar" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~sanctions-watchlist-delta-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-sanctions-watchlist-delta-monitor", "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/nexgendata~sanctions-watchlist-delta-monitor/runs": { "post": { "operationId": "runs-sync-nexgendata-sanctions-watchlist-delta-monitor", "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/nexgendata~sanctions-watchlist-delta-monitor/run-sync": { "post": { "operationId": "run-sync-nexgendata-sanctions-watchlist-delta-monitor", "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": { "lists": { "title": "Sanctions lists", "type": "array", "description": "Which official lists to monitor: ofac (US Treasury SDN), un (UN Security Council), uk (UK OFSI).", "default": [ "ofac", "un", "uk" ], "items": { "type": "string" } }, "mode": { "title": "Mode", "enum": [ "full", "delta" ], "type": "string", "description": "delta = only what changed since the last run (first run per list creates a baseline). full = all current entries.", "default": "delta" }, "watchlist": { "title": "Watchlist (optional)", "type": "array", "description": "Only emit entities whose name or alias matches one of these names. Empty = monitor the entire list.", "default": [], "items": { "type": "string" } }, "fuzzy": { "title": "Fuzzy watchlist matching", "type": "boolean", "description": "Also match near-spellings of watchlist names (opt-in).", "default": false }, "since": { "title": "Since (optional)", "type": "string", "description": "ISO date. Reserved for date-scoped queries." }, "include_raw": { "title": "Include raw record", "type": "boolean", "description": "Attach the raw parsed source record to each output row.", "default": false }, "max_emit": { "title": "Max rows emitted", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Safety cap on rows per run (mainly relevant to full mode without a watchlist).", "default": 10000 } } }, "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 } } } } } } } } } } ```