{
"openapi": "3.0.1",
"info": {
"title": "Sanctions List Screening API: EU, UN, OFAC SDN, UK",
"description": "Bulk-screen people and companies against official EU, UN, OFAC SDN and UK sanctions lists: fuzzy match score, matched alias, programs, birth dates, source link, new-listing alerts. No API key, no login. MCP-ready for AI agents. Pay per result, no monthly rental. $3 per 1,000 names screened.",
"version": "0.1",
"x-build-id": "PnbCP0eh8yd3PFZ9e"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/actose~ecb-style-eu-sanctions-list/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-actose-ecb-style-eu-sanctions-list",
"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/actose~ecb-style-eu-sanctions-list/runs": {
"post": {
"operationId": "runs-sync-actose-ecb-style-eu-sanctions-list",
"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/actose~ecb-style-eu-sanctions-list/run-sync": {
"post": {
"operationId": "run-sync-actose-ecb-style-eu-sanctions-list",
"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",
"newListings"
],
"type": "string",
"description": "screen: check each name below against the selected sanctions lists (1 result per name). newListings: report people and entities recently added to the lists (ideal for a daily schedule); the names field is ignored.",
"default": "screen"
},
"names": {
"title": "Names to screen",
"type": "array",
"description": "One person or organisation per line, in any script (Latin, Cyrillic, Arabic, Chinese...). Examples: 'Wagner Group', 'Vladimir Putin', 'Acme Trading LLC'. Duplicates and blank lines are skipped for free.",
"items": {
"type": "string"
}
},
"namesText": {
"title": "Names to screen (paste a column)",
"type": "string",
"description": "Optional: paste a column from Excel / Google Sheets, one name per line. Added to the list above."
},
"lists": {
"title": "Sanctions lists",
"type": "array",
"description": "Official lists to check. eu = EU Financial Sanctions Files (FSF) consolidated list; un = UN Security Council consolidated list; ofac = US Treasury OFAC SDN list; ofac-nonsdn = OFAC consolidated non-SDN lists (SSI, NS-MBS, CAPTA...); uk = UK Sanctions List (FCDO).",
"items": {
"type": "string",
"enum": [
"eu",
"un",
"ofac",
"ofac-nonsdn",
"uk"
],
"enumTitles": [
"EU consolidated list (FSF)",
"UN Security Council list",
"OFAC SDN (USA)",
"OFAC non-SDN consolidated (USA)",
"UK Sanctions List (FCDO)"
]
},
"default": [
"eu",
"un",
"ofac"
]
},
"threshold": {
"title": "Match threshold (0.5 - 1.0)",
"minimum": 0.5,
"maximum": 1,
"type": "number",
"description": "Minimum similarity score for a list record to be returned as a match. 1.0 = exact name only, 0.85 = recommended (catches transliterations and small typos), 0.75 = broad (more false positives).",
"default": 0.85
},
"entityType": {
"title": "Record type",
"enum": [
"any",
"person",
"entity"
],
"type": "string",
"description": "Restrict matches to persons or to organisations (entities, vessels, aircraft). 'any' checks everything.",
"default": "any"
},
"maxMatchesPerName": {
"title": "Max matches per name",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Maximum number of list records returned for each screened name (best scores first).",
"default": 5
},
"onlyNew": {
"title": "Only new (for scheduled runs)",
"type": "boolean",
"description": "Screen mode: output (and pay for) only names that have a match not seen in previous runs with the same state key. New listings mode: report only records added since the previous run's snapshot (the first run just saves the snapshot).",
"default": false
},
"newListingsDays": {
"title": "New listings: look-back window (days)",
"minimum": 0,
"maximum": 365,
"type": "integer",
"description": "New listings mode: report EU, UN and UK records listed in the last N days (OFAC files publish no listing date; OFAC additions are detected by comparison with the previous run). 0 = only use the snapshot comparison.",
"default": 7
},
"stateKey": {
"title": "State key",
"type": "string",
"description": "Name of the memory used by 'Only new' and by new-listings snapshots. Use a different key for each schedule or customer portfolio.",
"default": "default"
},
"cacheHours": {
"title": "Reuse downloaded lists for (hours)",
"minimum": 0,
"maximum": 24,
"type": "integer",
"description": "Official lists are downloaded, parsed and kept in your account's 'sanctions-lists-cache' store. Runs within this window reuse that copy (faster, cheaper). 0 = always download a fresh copy. The list version used is reported in every result (listVersions).",
"default": 6
},
"failOnListError": {
"title": "Fail if a list cannot be downloaded",
"type": "boolean",
"description": "Recommended for compliance. If one selected list is unavailable the run stops and nothing is charged. If off, names are screened against the lists that loaded and each result is flagged incomplete: true.",
"default": true
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}