# OFAC Sanctions List Search & Alerts: SDN Screening (`radiant_opuntia/ofac-sanctions-alerts`) Actor

Screen names, wallets and IDs against the OFAC SDN and consolidated sanctions lists with fuzzy matching, or get alerts when the list changes (new designations, updates, delistings). Straight from the U.S. Treasury, flat JSON, no API key.

- **URL**: https://apify.com/radiant_opuntia/ofac-sanctions-alerts.md
- **Developed by:** [GovData Feeds](https://apify.com/radiant_opuntia) (community)
- **Categories:** Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

**Screen names against the OFAC SDN and consolidated sanctions lists in bulk, with fuzzy matching, and get alerts when entries are added, updated or removed.**

**Rate your experience:** if you have used this Actor, you can tell us how it went on the [reviews page](https://apify.com/radiant_opuntia/ofac-sanctions-alerts/reviews). Honest feedback of any kind helps us improve it.

### What it does and who it is for

This Actor downloads the **official OFAC Sanctions List Service files** from the US Treasury (SDN and consolidated, no key) and returns one flat record per sanctions entry: **name, entry type (individual, entity, vessel, aircraft), programs, aliases, addresses and countries, date and place of birth, nationality, ID numbers, crypto addresses, emails, websites, linked-to, vessel details, remarks and a link to the official Sanctions List Search page**.

Two modes: **Screening** (enter a batch of names and get matches with a score, matched name and matched alias; also search ID numbers, crypto wallets, vessel IMO numbers and addresses), and **Alerts** (turn on **Only list changes** to compare today's list with the previous run and output entries that were **added, updated or removed**). Filter by list, entity type, program (for example `RUSSIA-EO14024` or `IRAN`) and country.

#### Use cases

- **Compliance and KYC teams:** batch-screen customers, vendors and counterparties against the SDN list.
- **Fintech, crypto and marketplaces:** check names, wallet addresses and IDs.
- **Trade, shipping and logistics:** screen vessels and consignees.
- **Law firms and sanctions advisers:** a daily feed of new designations by program or country.
- **AI agents:** answer "is this company or wallet address on the SDN list?".

### Why use this instead of the free official site or API

The underlying data is public and the official sources are free. What this Actor adds is convenience: batch screening and change alerts in one input.

| What you need | Official site / API | This Actor |
|---|---|---|
| Screening many names | The web Sanctions List Search tool checks one search at a time | A list of names in one run, each with a match score |
| Working with the list files | Downloads are split across several files (entries, aliases, addresses, comments) that you join | Joined into one record per entry, with aliases, addresses and IDs as lists |
| Spelling and word-order differences | Depends on the tool settings | Fuzzy matching ignores accents, punctuation and word order, with an adjustable minimum score |
| Wallets, IDs and vessels | Free-text identifier fields | Search identifiers directly; matches return a score of 100 |
| New designations | Review recent actions manually | Alerts mode returns added, updated and removed entries since the previous run |

If you only need a single lookup now and then, the official site is fine. If you want the same data on a schedule, as flat rows you can feed to a spreadsheet, CRM or agent, this saves the glue work.

### Data fields

| Field | Type | What it contains |
|---|---|---|
| `listName` | text | Which list the entry is on (SDN or the consolidated non-SDN list). |
| `entityId` | text | OFAC entry ID. |
| `name` | text | Primary name of the entry. |
| `type` | text | individual, entity, vessel or aircraft. |
| `programs` | array | Sanctions program tags (for example RUSSIA-EO14024). |
| `title` | text | Title, for individuals. |
| `aliases` | array | Known aliases (a.k.a., f.k.a., n.k.a.). |
| `addresses` | array | Addresses as published. |
| `countries` | array | Countries from addresses, nationality or vessel flag. |
| `dob` | text | Date(s) of birth. |
| `pob` | text | Place(s) of birth. |
| `nationality` | text | Nationality. |
| `gender` | text | Gender. |
| `idNumbers` | array | ID numbers such as passport, tax ID and registration numbers. |
| `cryptoAddresses` | array | Digital currency addresses. |
| `emails` | array | Email addresses listed on the entry. |
| `websites` | array | Websites listed on the entry. |
| `linkedTo` | text | Entries this one is linked to. |
| `listingDate` | text | Listing date, when published. |
| `callSign` | text | Vessel or aircraft call sign. |
| `vesselType` | text | Vessel type. |
| `tonnage` | text | Vessel tonnage. |
| `grossRegisteredTonnage` | text | Gross registered tonnage. |
| `vesselFlag` | text | Vessel flag country. |
| `vesselOwner` | text | Vessel owner. |
| `remarks` | text | Remarks text from OFAC. |
| `changeType` | text | In alerts mode: added, updated or removed. `null` in screening mode. |
| `matchScore` | integer | Screening match score from 0 to 100 (100 means identical or an identifier match). |
| `matchedName` | text | The name or alias that matched. |
| `matchedOn` | text | The search term that produced the match. |
| `url` | text | Link to the entry on the official OFAC Sanctions List Search site. |
| `listPublishedDate` | date | Publication date of the list file used. |
| `source` | text | Source of the data. |
| `scrapedAt` | datetime | When the Actor collected the record (UTC). |

Fields a source does not publish are `null`. Fields are empty when OFAC does not publish them for an entry.

### "New since yesterday" alerts

In **Only list changes** mode the Actor compares today's list with a snapshot saved by the previous run and outputs the entries that changed.

1. Open the Actor in Apify Console and set the input, with **Only list changes** switched on and a fixed alert name (`stateKey`). Example input:

```json
{
  "programs": ["RUSSIA-EO14024"],
  "alertOn": ["added", "updated"],
  "emitAllOnFirstRun": false,
  "onlyNew": true,
  "stateKey": "russia-new-designations"
}
```

2. Click **Save as task**, then open **Schedules**, create a schedule (for example the cron expression `0 7 * * *` for every day at 7:00 in the time zone you pick) and add the task to it.
3. Under the task's **Integrations**, send the results to Slack, email, Google Sheets, a webhook or your own system.

Keep **Max results** high in alerts mode (see the limits below).

With the default settings the first run only records a baseline and returns nothing; tick **Emit all on first run** to output all matching entries once. Later runs return only entries that were added, updated or removed (as selected in **Alert on**). Use a different alert name for each task so each keeps its own memory. A run with nothing new returns no results.

### Cost per run

This Actor uses **pay-per-result pricing: $3.00 per 1,000 results ($0.003 per result)**, with the Apify platform fee included. You are charged for the records a run returns and nothing is added on top for platform usage. A run that finds nothing new returns no results, so it has no per-result charge. The **Max results** input caps what a run can return (and so what it can cost).

**Worked example:** screening 20 names where 35 match candidates are returned costs 35 × $0.003 = $0.105. An alert run that returns 12 changes costs $0.036. Outputting the whole list would be thousands of results, so use filters and keep Max results in check.

The pricing is configured in Apify Console; the Pricing tab on this page is the authoritative source if it ever differs from this text.

### Example input and output

The output below comes from real test runs of this Actor. Email addresses are masked and very long text is shortened here; the Actor returns the full values.

Input used for the example:

```json
{
  "searchNames": ["Sberbank", "Wagner Group"],
  "matchMode": "fuzzy",
  "minMatchScore": 85,
  "maxResults": 50
}
```

Output (the first 2 records of a test run):

```json
[
  {
    "listName": "SDN (Specially Designated Nationals)",
    "entityId": "22543",
    "name": "PRIVATE MILITARY COMPANY 'WAGNER'",
    "type": "entity",
    "programs": ["TCO", "UKRAINE-EO13660", "CAR", "RUSSIA-EO14024"],
    "title": null,
    "aliases": ["PMC WAGNER", "CHASTNAYA VOENNAYA KOMPANIYA 'VAGNER'", "CHVK VAGNER", "WAGNER GROUP"],
    "addresses": ["Russia"],
    "countries": ["Russia"],
    "dob": null,
    "pob": null,
    "nationality": null,
    "gender": null,
    "idNumbers": [],
    "cryptoAddresses": [],
    "emails": [],
    "websites": [],
    "linkedTo": null,
    "listingDate": null,
    "callSign": null,
    "vesselType": null,
    "tonnage": null,
    "grossRegisteredTonnage": null,
    "vesselFlag": null,
    "vesselOwner": null,
    "remarks": "Secondary sanctions risk: Ukraine-/Russia-Related Sanctions Regulations, 31 CFR 589.201 and/or 589.209; alt. Secondary sanctions risk: See Section 11 of Executive Order 14024.",
    "changeType": null,
    "matchScore": 100,
    "matchedName": "WAGNER GROUP",
    "matchedOn": "Wagner Group",
    "url": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=22543",
    "listPublishedDate": "2026-10-20",
    "source": "U.S. Treasury OFAC Sanctions List Service",
    "scrapedAt": "2026-10-23T12:28:17.998Z"
  },
  {
    "listName": "SDN (Specially Designated Nationals)",
    "entityId": "36422",
    "name": "LIMITED LIABILITY COMPANY SBERBANK REAL ESTATE CENTER",
    "type": "entity",
    "programs": ["RUSSIA-EO14024"],
    "title": null,
    "aliases": ["TSENTR NEDVIZHIMOSTI OT SBERBANKA"],
    "addresses": ["32/1 Kutuzovsky Ave, Moscow 121170, Russia"],
    "countries": ["Russia"],
    "dob": null,
    "pob": null,
    "nationality": null,
    "gender": null,
    "idNumbers": ["Registration Number 1157746652150 (Russia)"],
    "cryptoAddresses": [],
    "emails": [],
    "websites": [],
    "linkedTo": "PUBLIC JOINT STOCK COMPANY SBERBANK OF RUSSIA",
    "listingDate": null,
    "callSign": null,
    "vesselType": null,
    "tonnage": null,
    "grossRegisteredTonnage": null,
    "vesselFlag": null,
    "vesselOwner": null,
    "remarks": "Secondary sanctions risk: See Section 11 of Executive Order 14024.; Tax ID No. 7736249247 (Russia); Registration Number 1157746652150 (Russia); a.k.a. 'SREC LLC'; Linked To: PUBLIC JOINT STOCK COMPANY SBERBANK OF RUSSIA.",
    "changeType": null,
    "matchScore": 96,
    "matchedName": "LIMITED LIABILITY COMPANY SBERBANK REAL ESTATE CENTER",
    "matchedOn": "Sberbank",
    "url": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=36422",
    "listPublishedDate": "2026-10-20",
    "source": "U.S. Treasury OFAC Sanctions List Service",
    "scrapedAt": "2026-10-23T12:28:17.998Z"
  }
]
```

### Limits worth knowing

- **This is a screening aid, not a compliance determination.** Fuzzy matching returns false positives, so review matches and confirm on the official OFAC site.
- Results reflect the list OFAC published most recently; check `listPublishedDate`.
- In alerts mode, the first run only records a baseline unless you tick **Emit all on first run**.
- In alerts mode the snapshot is saved after the full comparison, so changes beyond **Max results** are not output and are not re-sent on the next run. Keep Max results high (the default is 1,000) for alerts.
- The Actor needs more memory than the others (512 MB) because it parses the full list in memory.
- Lowering the minimum match score returns more candidates and more false positives. A score of 85 is a good start.

### FAQ

#### Do I need an API key?

No. The Actor reads the public OFAC Sanctions List Service files.

#### Which lists are included?

The SDN list and the consolidated (non-SDN) lists such as sectoral sanctions and foreign sanctions evaders. SDN is selected by default.

#### Can I check a crypto address or an IMO number?

Yes. Put it under **Identifiers**; a match returns a score of 100.

#### How do I get alerts for new designations?

Turn on **Only list changes**, choose the programs or countries you care about and schedule it daily.

#### Is a match a confirmed hit?

No. A match means a name is similar. Review it and verify on the official OFAC site before acting.

### Related Actors

More Actors from GovData Feeds, all on Apify:

- [sam-gov-opportunities-alerts](https://apify.com/radiant_opuntia/sam-gov-opportunities-alerts): New SAM.gov federal contract opportunities and bid alerts
- [grants-gov-alerts](https://apify.com/radiant_opuntia/grants-gov-alerts): US federal grant opportunities (Grants.gov): ceilings, deadlines, eligibility
- [sec-form-d-alerts](https://apify.com/radiant_opuntia/sec-form-d-alerts): SEC Form D filings: companies that just raised money
- [usaspending-awards-alerts](https://apify.com/radiant_opuntia/usaspending-awards-alerts): New federal contract, grant and loan awards (USAspending)
- [sec-form4-insider-alerts](https://apify.com/radiant_opuntia/sec-form4-insider-alerts): SEC Form 4 insider buys and sells, one row per transaction
- [fda-recall-alerts](https://apify.com/radiant_opuntia/fda-recall-alerts): FDA food, drug and medical device recalls
- [fda-compliance-alerts](https://apify.com/radiant_opuntia/fda-compliance-alerts): FDA 510(k) clearances, MAUDE adverse events and warning letters
- [cpsc-recall-alerts](https://apify.com/radiant_opuntia/cpsc-recall-alerts): CPSC consumer product safety recalls
- [us-building-permits-alerts](https://apify.com/radiant_opuntia/us-building-permits-alerts): New building permits from nine city open-data portals
- [clinical-trials-alerts](https://apify.com/radiant_opuntia/clinical-trials-alerts): New ClinicalTrials.gov studies by condition, sponsor and phase
- [federal-register-alerts](https://apify.com/radiant_opuntia/federal-register-alerts): Federal Register rules, proposed rules and notices
- [contractor-license-alerts](https://apify.com/radiant_opuntia/contractor-license-alerts): New contractor licenses in WA, OR and NY with bond and insurance
- [new-business-registrations-alerts](https://apify.com/radiant_opuntia/new-business-registrations-alerts): New LLC and corporation registrations (NY, CO, OR, CT)
- [epa-echo-enforcement-alerts](https://apify.com/radiant_opuntia/epa-echo-enforcement-alerts): EPA ECHO facilities with new environmental penalties
- [restaurant-inspections-alerts](https://apify.com/radiant_opuntia/restaurant-inspections-alerts): Restaurant health inspections from seven US jurisdictions
- [code-violations-alerts](https://apify.com/radiant_opuntia/code-violations-alerts): Building, housing and property code violations from six cities

*Data comes from the US Treasury Office of Foreign Assets Control (OFAC) Sanctions List Service, a US government source. This Actor is not affiliated with or endorsed by OFAC or the US Treasury. It is a screening aid, not legal or compliance advice, and does not replace official screening obligations.*

# Actor input Schema

## `searchNames` (type: `array`):

People, companies, vessels or aliases to look up, e.g. 'Sberbank' or 'Vladimir Putin'. Names are matched in any word order, ignoring accents and punctuation, against the primary name and all aliases (a.k.a.). Leave empty to list or monitor the whole list.

## `matchMode` (type: `string`):

Fuzzy tolerates typos and different spellings (recommended for compliance screening). Contains finds the text anywhere in a name. Exact only returns identical names.

## `minMatchScore` (type: `integer`):

For fuzzy matching, only return names scoring at least this. Lower = more candidates and more false positives. 85 is a good start.

## `identifiers` (type: `array`):

Search the free-text identifiers and addresses on each entry, e.g. a crypto wallet address, an IMO vessel number, a passport or tax ID number, an email or a street. Matches return a score of 100.

## `lists` (type: `array`):

SDN is the main OFAC blocking list. Consolidated holds the non-SDN lists (sectoral sanctions, foreign sanctions evaders, non-SDN Palestinian Legislative Council and others).

## `entityTypes` (type: `array`):

Leave empty for all types.

## `programs` (type: `array`):

OFAC program tags, e.g. RUSSIA-EO14024, SDGT, IRAN, CUBA, DPRK, VENEZUELA, CYBER2, NPWMD. A prefix also matches (IRAN matches IRAN-HR and IRAN-EO13846). Leave empty for all.

## `countries` (type: `array`):

Keep entries with an address, nationality or vessel flag in these countries, e.g. 'Russia', 'Iran', 'Hong Kong'.

## `onlyNew` (type: `boolean`):

Compare today's list with the snapshot saved by the previous run and output only entries that were added, updated or removed. Use with a daily Schedule and an email/Slack/webhook integration. The first run saves a baseline and returns nothing (unless you tick the option below).

## `alertOn` (type: `array`):

Used with 'Only list changes'. Which changes to output.

## `emitAllOnFirstRun` (type: `boolean`):

In alerts mode, the first run normally just records a baseline. Tick this to output all matching entries once on that first run.

## `stateKey` (type: `string`):

Separate memory for each alert, e.g. 'russia-new-designations'. Use a different name for each Schedule so they don't share a baseline.

## `maxResults` (type: `integer`):

Stop after this many entries. In alerts mode, changes beyond this cap are not output and are not re-sent on the next run, so keep it high for alerts.

## Actor input object example

```json
{
  "searchNames": [
    "Sberbank",
    "Wagner Group"
  ],
  "matchMode": "fuzzy",
  "minMatchScore": 85,
  "identifiers": [],
  "lists": [
    "sdn"
  ],
  "entityTypes": [],
  "programs": [],
  "countries": [],
  "onlyNew": false,
  "alertOn": [
    "added",
    "updated"
  ],
  "emitAllOnFirstRun": false,
  "maxResults": 50
}
```

# Actor output Schema

## `results` (type: `string`):

All OFAC sanctions list entry records returned by this run (flat JSON items in the default dataset).

## `runSummary` (type: `string`):

Counts of items pushed and items skipped as already seen (only-new mode).

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchNames": [
        "Sberbank",
        "Wagner Group"
    ],
    "matchMode": "fuzzy",
    "minMatchScore": 85,
    "lists": [
        "sdn"
    ],
    "onlyNew": false,
    "alertOn": [
        "added",
        "updated"
    ],
    "emitAllOnFirstRun": false,
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("radiant_opuntia/ofac-sanctions-alerts").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchNames": [
        "Sberbank",
        "Wagner Group",
    ],
    "matchMode": "fuzzy",
    "minMatchScore": 85,
    "lists": ["sdn"],
    "onlyNew": False,
    "alertOn": [
        "added",
        "updated",
    ],
    "emitAllOnFirstRun": False,
    "maxResults": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("radiant_opuntia/ofac-sanctions-alerts").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchNames": [
    "Sberbank",
    "Wagner Group"
  ],
  "matchMode": "fuzzy",
  "minMatchScore": 85,
  "lists": [
    "sdn"
  ],
  "onlyNew": false,
  "alertOn": [
    "added",
    "updated"
  ],
  "emitAllOnFirstRun": false,
  "maxResults": 50
}' |
apify call radiant_opuntia/ofac-sanctions-alerts --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,radiant_opuntia/ofac-sanctions-alerts"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/tnJbOcUKrK0VCqlWz/builds/ujNyKqUTm9DVjhaL8/openapi.json
