# OneShot Agent API – Company Sanctions Lookup

> OneShot Agent API – Company Sanctions Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-19).

Check whether a company name appears on US Treasury sanctions lists (Specially Designated Nationals), returning scored fuzzy matches with program, address, and alias details.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/company-sanctions?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-company-sanctions-lookup-7fe884f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9XbRpY_edRBqNUVqwXsjL

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 oneshot-agent-api-company-sanctions-lookup-7fe884f0 -d '<json body>'
```

Example prompt: Can you check whether 'Banco Nacional de Cuba' is on any US Treasury sanctions lists? Return up to 5 matches with a minimum score of 0.85.

## When to prefer this

Use this endpoint when you need a lightweight, pay-per-call OFAC SDN sanctions check against a company name without managing API keys or subscriptions. Ideal for agent workflows performing KYB, vendor onboarding, or deal-flow compliance screening where fuzzy name matching with scored results is needed. Prefer this over full KYB platforms when you only need sanctions screening and want micro-payment (USDC on Base) access with no account setup.

## Known failure modes

- Company name fewer than 2 or more than 200 characters returns a validation error
- min_score outside 0.5–1 range returns a parameter error
- No matches found returns empty matches array with total 0
- Network or upstream OFAC data source unavailability returns a 5xx error
- Ambiguous or very common company names may return many low-relevance fuzzy matches if min_score is set too low

## How this service works

Entries on the US Treasury's list of Specially Designated Nationals that match a company name, each with a score, the name that matched and the entry as the list publishes it. A screening aid, not a legal determination. No match means no entry on the lists named scored at or above the minimum; it does not mean the party is clear.

## Output

Returns a JSON object with the name and date of the sanctions list checked, the total number of matches at or above the score threshold, and an array of matched entries each containing the official entry name, score, matched name, SDN program codes, remarks, title, addresses, and known aliases (a.k.a. entries).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "The company name to check, 2 to 200 characters, free text. Word order and punctuation do not matter"
  },
  "limit": {
   "type": "number",
   "description": "Most matches to return, highest score first (1-25, default 10). total counts all matches at or above min_score"
  },
  "min_score": {
   "type": "number",
   "description": "The lowest score of a match to return, 0.5 to 1 (default 0.85). 1 is the same words in any order; lower scores are spelling variants and a missing or extra word"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lists": [
   {
    "name": "US Treasury list of Specially Designated Nationals",
    "as_of": "2026-10-13T00:00:00.000Z"
   }
  ],
  "total": 1,
  "matches": [
   {
    "entry": {
     "name": "BANCO NACIONAL DE CUBA",
     "title": null,
     "number": "306",
     "remarks": "a.k.a. 'BNC'.",
     "programs": [
      "CUBA"
     ],
     "addresses": [],
     "other_names": [
      {
       "kind": "aka",
       "name": "NATIONAL BANK OF CUBA"
      }
     ]
    },
    "score": 1,
    "matched_name": "BANCO NACIONAL DE CUBA"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-company-sanctions-lookup-7fe884f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)