# OFAC SDN Entity Name Search

> OFAC SDN Entity Name Search is a paid API for AI agents from apiacre.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-12).

Searches OFAC SDN and Consolidated Non-SDN sanction lists by entity name, returning scored candidate matches with program tags, alias quality, and source file evidence without issuing a compliance verdict.

## Facts

- Endpoint: POST https://apiacre.com/v1/research/ofac-entity-search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ofac-sdn-entity-name-search-dd17e166
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GKgvRjC5Vpx8_XaRrGAai

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-sdn-entity-name-search-dd17e166 -d '<json body>'
```

Example prompt: Can you search the OFAC SDN and Consolidated Non-SDN lists for 'Aerocaribbean Airlines' as an Entity type, return up to 5 candidates with a minimum score of 85, and tell me the match score, which sanctions programs it's tagged under, and how fresh the underlying list data is?

## When to prefer this

Use this endpoint when you need deterministic, auditable OFAC name-matching with cryptographic source evidence (SHA256 file hashes and publication dates) rather than a black-box allow/block verdict. It is ideal for compliance workflows that require human review of candidates, integration into AML/KYC pipelines, or any context where you need to document exactly which version of the OFAC list was searched. Prefer it over generic sanctions APIs when you need program-level tags, alias quality indicators, and freshness timestamps for regulatory audit trails.

## Known failure modes

- No candidates found if the name has no similarity above the minimum score threshold — status returns 'no_candidates'
- Stale snapshot if the OFAC list has not refreshed within the cache window — freshness evidence indicates last fetch time
- Malformed entity name or unsupported entity type returns a validation error
- Score threshold set too high may exclude partial matches that warrant manual review
- Network timeout if the OFAC source list is temporarily unavailable during snapshot refresh

## How this service works

Compare a business or organization name with separately named Entity records and aliases in the official OFAC SDN and Consolidated Non-SDN files, returning deterministic candidate scores, program tags, source hashes, and freshness evidence without issuing an allow or block verdict.

## Output

Returns a JSON object containing: query echo (normalized name, entity type, thresholds), dataset metadata (per-file SHA256 hashes, publication dates, record counts, snapshot fetch timestamp, cache max-age), and an array of scored candidates each with match score, match method (exact/fuzzy), matched name, alias quality, list kind (SDN or Consolidated Non-SDN), sanctions program codes, associated countries, and source file URL. Includes guidance links and a disclaimer that results are for review only and do not constitute a compliance determination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "entity_name": {
   "type": "string"
  },
  "max_results": {
   "type": "integer"
  },
  "minimum_score": {
   "type": "integer"
  },
  "include_weak_aliases": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": {
    "entityName": "AEROCARIBBEAN AIRLINES",
    "entityType": "Entity",
    "maxResults": 5,
    "minimumScore": 85,
    "normalizedName": "aerocaribbean airlines"
   },
   "source": "https://ofac.treasury.gov/sanctions-list-service",
   "status": "candidates_found",
   "dataset": {
    "files": [
     {
      "filename": "sdn.xml",
      "listKind": "sdn",
      "listLabel": "SDN",
      "publishDate": "2026-08-07",
      "recordCount": 19199
     }
    ],
    "snapshotFetchedAt": "2026-08-12T02:00:00+00:00",
    "cacheMaxAgeSeconds": 3600
   },
   "guidance": {
    "automation": "https://ofac.treasury.gov/faqs/287",
    "fiftyPercentRule": "https://ofac.treasury.gov/faqs/10"
   },
   "candidates": [
    {
     "uid": "36",
     "listKind": "sdn",
     "listLabel": "SDN",
     "entityType": "Entity",
     "primaryName": "AEROCARIBBEAN AIRLINES"
    }
   ],
   "disclaimer": "Evidence aid only. Not legal advice, a compliance certification, or a sole ba...",
   "limitations": [
    "Results are name-similarity candidates for manual review, not a determination...",
    "This search covers separately named Entity records and their aliases only; it...",
    "Different OFAC lists and program tags carry different restrictions; inspect t...",
    "Name-only screening can produce false positives and false negatives. Weak ali..."
   ],
   "retrievedAt": "2026-08-12T02:00:01+00:00",
   "candidateCount": 1,
   "candidatesReturned": 1,
   "candidatesTruncated": false
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": [
    {
     "path": "/v1/research/organization-evidence",
     "title": "Official supplier evidence report",
     "method": "POST",
     "reason": "Add independent GLEIF legal-entity, USAspending prime-contract, and SEC filin...",
     "service": "research.organization-evidence"
    }
   ]
  },
  "service": "research.ofac-entity-search",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ofac-sdn-entity-name-search-dd17e166/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)