# OFAC SDN Fuzzy Screen API

> OFAC SDN Fuzzy Screen API is a paid API for AI agents from x402-ofac-api.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Fuzzy-matches a person or organization name against the OFAC Specially Designated Nationals (SDN) list, including aliases, and returns scored potential matches.

## Facts

- Endpoint: POST https://x402-ofac-api.vercel.app/ofac-sdn?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ofac-sdn-fuzzy-screen-api-d2ee39db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d9MUxKYszzH8gl70Mvrxu

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-fuzzy-screen-api-d2ee39db -d '<json body>'
```

Example prompt: Screen the name 'Viktor Petrov' against the OFAC SDN list using a match threshold of 0.65 and return up to 10 potential hits with their scores.

## When to prefer this

Use this endpoint when you need a fast, pay-per-call fuzzy OFAC SDN screening check without maintaining your own sanctions database. It is ideal for lightweight compliance workflows, agent-driven KYC pipelines, and one-off counterparty checks where you want scored match candidates including alias coverage. Prefer this over a manual OFAC search when you need programmatic, scored results with configurable thresholds at low per-call cost.

## Known failure modes

- Empty query string returns an error or empty results
- Threshold set above 1.0 or below 0 may cause a validation error
- Limit exceeding 50 may be capped or rejected
- Very common names may return many false-positive hits at low thresholds
- Highly misspelled names may return no matches even for sanctioned entities
- Network or server errors on the Vercel-hosted endpoint may return 5xx responses

## How this service works

Pay-per-call directional OFAC SDN screen for AI agents (USDC on Base + Solana via x402). Potential matches only — not clearance.

## Output

Returns a list of scored potential matches from the OFAC SDN list, including matched aliases and a similarity score for each hit. The results indicate how closely the queried name resembles sanctioned individuals or entities, but do not constitute a legal clearance determination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max hits to return (default 25, max 50)"
  },
  "query": {
   "type": "string",
   "description": "Name or alias to screen"
  },
  "threshold": {
   "type": "number",
   "description": "Match threshold 0-1 (default 0.55)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hits": [
   {
    "score": 1,
    "entity": {
     "name": "BANCO NACIONAL DE CUBA"
    },
    "match_via": "primary"
   }
  ],
  "query": "BANCO NACIONAL DE CUBA",
  "hit_count": 1,
  "disclaimer": "Directional OFAC SDN screen only...",
  "list_as_of": "2026-10-10T04:18:02.953473+00:00",
  "potential_matches_only": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ofac-sdn-fuzzy-screen-api-d2ee39db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-ofac-api.vercel.app](https://www.zero.xyz/host/x402-ofac-api.vercel.app/llms.txt)
