OFAC Sanctions Changes Feed: Entities, Vessels & Aircraft

Every change OFAC (US Treasury, Office of Foreign Assets Control) makes to its sanctions lists, delivered as clean JSON: companies, banks, vessels and aircraft added, removed or amended, one record per change, straight from the official OFAC Sanctions List Service (SLS).

Built for compliance / KYC / AML teams, trade and export-control desks, shipping and maritime risk, fintechs and payment processors who need to know what changed since yesterday, not re-download a 110 MB list.

• Official source only: SLS delta files (/changes/{publicationId}), publication history (/changes/history/{year}) and the SDN / Consolidated XML exports. No scraping, no third-party aggregators.
• Change-level data: added (new designations), removed (delistings), amended (new aliases, addresses, IDs, programs, vessel flag/name changes) with a plain-English amendmentSummary.
• Screening-ready fields: primary name + all aliases (incl. Cyrillic / Chinese / Arabic script), programs (RUSSIA-EO14024, IRAN-EO13902, SDGT...), lists (SDN / non-SDN), legal authorities, IMO, MMSI, call sign, flag, vessel type and build year, aircraft tail number / model / serial, company tax and registration IDs (INN, OGRN, USCC, RFC...), website, date established, secondary-sanctions risk, remarks, related entities.
• Filters: programs (exact or prefix: RUSSIA = all Russia programs), countries (address, vessel flag, registration country), record types (entity / vessel / aircraft), change types, days back, max items.
• Schedules: sinceLastRun mode delivers each publication's changes exactly once per State key - perfect for a daily alert into Slack, email, a webhook or your case-management system.
• Never empty: if recent changes are sparse, the default run walks back through older publications and, if still short, tops up with currently listed records flagged changeType: "current".
• Entities only: individuals are never included (by design - no personal data). Addresses are reduced to city / state / country. Names of individuals referenced inside remarks (e.g. "Linked To: SURNAME, Given") are replaced with [individual].

Quick start

Run with {}: you get the newest publications' entity, vessel and aircraft changes (about 40 records, ~10 seconds).

Russia-related changes involving the UAE or Turkey in the last 90 days:

{ "programs": ["RUSSIA"], "countries": ["AE", "TR"], "daysBack": 90, "maxItems": 200 }

New vessel designations only (shadow-fleet watch):

{ "entityTypes": ["vessel"], "actionTypes": ["added"], "daysBack": 180 }

Daily alert feed (schedule it once a day):

{ "mode": "sinceLastRun", "stateKey": "daily-all", "maxItems": 500 }

Input

Field	Default	What it does
mode	window	window = publications in the last daysBack days, newest first, stateless. sinceLastRun = only publications/changes not delivered before for stateKey, oldest first.
daysBack	30	Lookback in days (US Eastern publication dates).
entityTypes	all	entity, vessel, aircraft. Individuals are not available.
actionTypes	all	added, removed, amended.
programs	all	OFAC program tags, exact or prefix (RUSSIA, IRAN, SDGT, CYBER, DPRK, ILLICIT-DRUGS...).
countries	all	ISO codes or OFAC country names; matches address countries, vessel flag and registration-ID issuing country.
maxItems	40	Hard cap on records (and spend).
autoExtend	true	Window mode: read older publications (up to 180 days) until at least 25 matches.
fallbackToCurrent	true	Window mode: top up with currently listed records (changeType: "current") if still short.
stateKey	default	Saved position for sinceLastRun; use one per schedule.

Output (one record per change)

{
  "changeType": "added",
  "action": "added",
  "publicationId": 1075,
  "publicationDate": "2026-10-21",
  "publicationType": "Standard Action",
  "entityId": 58873,
  "entityType": "vessel",
  "name": "WHALES DIAMOND",
  "aliases": [],
  "programs": ["IRAN-EO13902"],
  "lists": ["SDN List"],
  "sanctionsTypes": ["Block"],
  "legalAuthorities": ["Executive Order 13902 (Iran)"],
  "listedDate": "2026-10-21",
  "countries": ["United Arab Emirates"],
  "countryCodes": ["AE"],
  "imoNumber": "9375032",
  "mmsi": "470132000",
  "callSign": "A6E2076",
  "vesselFlag": "United Arab Emirates",
  "vesselType": "Crew/Supply Vessel",
  "vesselYearOfBuild": "2006",
  "registrationIds": [{ "type": "Vessel Registration Identification", "value": "IMO 9375032", "country": null }],
  "relatedEntities": [{ "type": "Property in the interest of", "relatedEntityId": 58810, "relatedName": "WHALES SHIPPING LINE LLC" }],
  "remarks": "(Linked To: WHALES SHIPPING LINE LLC)",
  "amendments": null,
  "amendmentSummary": null,
  "ofacUrl": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=58873",
  "deltaFileUrl": "https://sanctionslistservice.ofac.treas.gov/changes/1075",
  "ofacRecentActionsUrl": "https://ofac.treasury.gov/recent-actions/20261021"
}

Also on every record: addresses (city / stateOrProvince / country / countryCode), identifiers (all ID documents), attributes (other OFAC features), aircraftTailNumber, aircraftModel, aircraftSerialNumber, aircraftOperator, vesselOwner, vesselTonnage, website, establishedDate, organizationType, targetType, secondarySanctionsRisk, firstSeenAt. Amended records carry amendments (list of {action, field, value}) and a readable amendmentSummary, e.g. added sanctionsProgram "IRAN-CON-ARMS-EO". For amended records the other fields show the record's current listing. See sample-output.json for full examples.

The run summary (key-value store OUTPUT) lists the publications scanned, counts by change and record type, and why the run stopped.

How it works

1. Reads the SLS publication history (/changes/history/{year}) - OFAC publishes a few times a week, each with an ID.
2. Downloads each publication's official delta file (/changes/{id}, the same file /changes/latest serves for the newest one) and classifies each record as added / removed / amended.
3. Joins the SDN.XML and CONSOLIDATED.XML exports for remarks, vessel details and the current state of amended records.
4. Drops individuals, applies your filters, delivers.

Pricing

Pay per event: a small actor start fee plus one sanction-record event per delivered record. Your run's max charge is respected - you never get more records than you pay for. See the Pricing tab.

Notes and limits

• Data comes from the official OFAC SLS and is in the public domain. This Actor is a data feed, not a screening engine or legal advice - always confirm matches against the official OFAC lists.
• Publication dates are US Eastern. ofacRecentActionsUrl points at OFAC's Recent Actions page for that date (best-effort link).
• removed records show the record as it was when delisted.
• Individuals are excluded by design; remarks are passed through from OFAC except that individuals referenced in "Linked To:" notes are replaced with [individual] (OUTPUT.redactedRemarks counts them).