# OFAC Sanctions Name Search

> OFAC Sanctions Name Search is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.0045/call, status unknown (last checked 2026-10-28).

Fuzzy-matches a person, company, vessel, or aircraft name against the U.S. Treasury OFAC Specially Designated Nationals (SDN) list and returns scored candidate matches with SDN details.

## Facts

- Endpoint: GET https://1gateway.dev/v1/compliance/sanctions?utm_source=zero.xyz
- Price: $0.0045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ofac-sanctions-name-search-ac0c5df6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iKsWcB9L9Hd_RNx9xrZN9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ofac-sanctions-name-search-ac0c5df6
```

Example prompt: Before I send this payment, can you screen 'Lazarus Group' against the OFAC SDN list — fuzzy match is fine, but set the score threshold to 0.85 and show up to 10 results?

## When to prefer this

Choose this endpoint when an agent needs a quick, scored fuzzy-match against the OFAC SDN list specifically — especially for pre-payment, pre-onboarding, or pre-shipment compliance checks. It is ideal for agentic workflows that must make a pass/fail decision on a single name in real time. Prefer it over manual SDN lookups or broad third-party screening services when you need the raw OFAC SDN data with alias coverage, digital currency address flagging, and a machine-readable score in one call. Note: it covers the OFAC SDN list only, not OFAC non-SDN/Consolidated lists, EU, UN, or UK lists — use supplementary sources if broader multi-jurisdiction screening is required.

## Known failure modes

- Name not found: returns hit=false with an empty matches array when no candidate clears the min_score threshold
- Stale list warning: list.stale=true and a warning string if the SDN data has not refreshed recently
- Invalid min_score: error if min_score is outside the 0.6–1.0 range
- Name too long: error if name exceeds 200 characters
- No name provided: 400-style error because name is a required query parameter
- Non-Latin script input: fuzzy matching is over Latin-script names only; results may be unreliable for Arabic, Cyrillic, etc.

## How this service works

Use when an agent must check a person, company, vessel or aircraft against the U.S. Treasury OFAC SDN list before paying, onboarding or shipping. Input: name (fuzzy, aliases included), optional type, min_score, limit. Output: JSON potential matches with score, SDN entry, programs, countries, aliases, OFAC link, list as-of date, data age. Not a legal determination. Example: ?name=Lazarus+Group

## Output

Returns a JSON object containing: a boolean `hit` flag indicating any match above the threshold, a `potential_match` flag, the full query echo, metadata about the SDN list (publication date, staleness, entry count, alias count, digital currency address count), and an array of `matches` each with a fuzzy score (0–1), the matched alias or name, the SDN entry (UID, canonical name, type, programs, countries, aliases, digital currency addresses, OFAC detail URL), and a disclaimer that this is not a legal determination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "examples": [
        "Lazarus Group"
       ],
       "maxLength": 200,
       "description": "Person, company, vessel or aircraft name in Latin script; fuzzy match over SDN names and aliases"
      },
      "type": {
       "enum": [
        "entity",
        "individual",
        "vessel",
        "aircraft"
       ],
       "type": "string",
       "examples": [
        "entity"
       ],
       "description": "Only match this SDN entry type"
      },
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1,
       "examples": [
        10
       ],
       "description": "Max matches (default 10)"
      },
      "lists": {
       "type": "string",
       "pattern": "^(all|(ofac|eu|uk)(,(ofac|eu|uk))*)$",
       "examples": [
        "ofac"
       ],
       "maxLength": 20,
       "description": "Lists to search: ofac (default), eu, uk, comma-separated, or all"
      },
      "min_score": {
       "type": "number",
       "maximum": 1,
       "minimum": 0.6,
       "examples": [
        0.85
       ],
       "description": "Name match threshold 0.6-1 (default 0.85)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "list",
      "query",
      "candidates_scanned",
      "potential_match",
      "hit",
      "matches",
      "disclaimer"
     ],
     "properties": {
      "hit": {
       "type": "boolean"
      },
      "list": {
       "type": "object",
       "properties": {
        "as_of": {
         "type": "string"
        },
        "stale": {
         "type": "boolean"
        },
        "source": {
         "type": "string"
        },
        "aliases": {
         "type": "integer"
        },
        "entries": {
         "type": "integer"
        },
        
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hit": true,
  "list": {
   "as_of": "2026-10-15",
   "stale": false,
   "source": "U.S. Department of the Treasury, Office of Foreign Assets Control (OFAC): Specially Designated Nationals and Blocked Persons List (SDN)",
   "aliases": 2991,
   "entries": 2312,
   "version": "test-20261015",
   "published": "2026-10-15T16:34:34.000Z",
   "checked_at": "2026-10-18T05:00:00.000Z",
   "source_url": "https://ofac.treasury.gov/specially-designated-nationals-and-blocked-persons-list-sdn-human-readable-lists",
   "data_age_days": 0,
   "digital_currency_addresses": 512
  },
  "query": {
   "name": "Lazarus Group",
   "type": null,
   "min_score": 0.85,
   "normalized": "LAZARUS GROUP"
  },
  "matches": [
   {
    "entry": {
     "uid": 27307,
     "name": "LAZARUS GROUP",
     "type": "entity",
     "aliases": [],
     "ofacUrl": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=27307",
     "programs": [
      "DPRK3"
     ],
     "countries": [
      "Korea, North"
     ],
     "digitalCurrencyAddresses": [
      {
       "address": "0x098B716B8Aaf21512996dC57EB0615e2383E2f96",
       "currency": "ETH"
      }
     ]
    },
    "exact": true,
    "score": 1,
    "matchedOn": "LAZARUS GROUP"
   }
  ],
  "disclaimer": "Not a legal determination and not legal advice. Screening aid over the OFAC SDN list only (not the OFAC non-SDN/Consolidated lists, EU, UN or UK lists). Name r…",
  "potential_match": true,
  "candidates_scanned": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ofac-sanctions-name-search-ac0c5df6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)