# Hermes OFAC Sanctions Screening

> Hermes OFAC Sanctions Screening is a paid API for AI agents from hermes-counterparty-api.onrender.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Screens a named entity (person, organization, vessel, or aircraft) against the OFAC SDN sanctions list and returns match candidates with normalized name and source metadata.

## Facts

- Endpoint: POST https://hermes-counterparty-api.onrender.com/v1/entity-sanctions-screen
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-ofac-sanctions-screening-566ce56d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KvNlMXC4gNQv1l7s1cPyK

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 hermes-ofac-sanctions-screening-566ce56d -d '<json body>'
```

Example prompt: Can you run an OFAC SDN sanctions screen on 'Nordex Shipping LLC', which is an entity based in Russia, to check whether they appear on any US Treasury sanctions list before we wire them payment?

## When to prefer this

Use this endpoint when you need a fast, cheap ($0.02), automated OFAC SDN pre-screen for a named counterparty — individual, company, vessel, or aircraft — before initiating a payment, onboarding a customer, or signing a contract. It is especially useful in agentic workflows that need programmatic sanctions gating without calling a full KYC platform. Not a substitute for legal compliance review, but sufficient for automated first-pass due diligence.

## Known failure modes

- Empty or missing name field returns a validation error
- Name too long (>200 chars) rejected by schema
- Unrecognized entity_type enum value causes a 422 validation error
- Service unavailable on the free Render.com host (cold start or downtime)
- Payment of 0.02 USDC not fulfilled causes a 402 Payment Required response
- Partial name matches may return false positives requiring manual review
- Non-English or transliterated names may yield lower recall against SDN entries

## How this service works

Agent utilities for company research, package maintenance intelligence, dependency vulnerability checks, counterparty availability, SEC company snapshots, OFAC sanctions screening, and deterministic JSON/CSV data-quality work. Company domain intelligence includes a free preview before the paid enrichment call.

## Output

Returns a JSON object containing the normalized query name, a list of SDN match candidates (with OFAC source metadata), a boolean matches_found flag, and informational warnings reminding the caller that results are not a legal compliance determination. If no matches are found, candidates is an empty array.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1,
   "description": "Person, organization, vessel, or other entity name to screen against OFAC SDN"
  },
  "country": {
   "type": "string",
   "description": "Optional country filter matched against OFAC-published addresses"
  },
  "entity_type": {
   "enum": [
    "individual",
    "entity",
    "vessel",
    "aircraft"
   ],
   "type": "string",
   "description": "Optional OFAC entity-type filter"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "name": "ACME SHIPPING LLC",
   "country": null,
   "entity_type": null,
   "normalized_name": "acme shipping llc"
  },
  "source": {
   "list": "SDN",
   "provider": "OFAC"
  },
  "warnings": [
   "Screening result is informational and is not a legal compliance determination."
  ],
  "candidates": [],
  "matches_found": false,
  "schema_version": "1.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-ofac-sanctions-screening-566ce56d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hermes-counterparty-api.onrender.com](https://www.zero.xyz/host/hermes-counterparty-api.onrender.com/llms.txt)