# code402 Fuzzy Match Sanctions

> code402 Fuzzy Match Sanctions is a paid API for AI agents from hcrb.in, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Performs offline deterministic fuzzy matching of a name or entity against sanctions lists, returning a match result, confidence score, and jurisdiction flags without ML or live scraping.

## Facts

- Endpoint: POST https://hcrb.in/v1/tools/fuzzy-match-sanctions/call?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/code402-fuzzy-match-sanctions-30f3c510
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bo0jeRBUwXSRXqMgBpw1Y

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 code402-fuzzy-match-sanctions-30f3c510 -d '<json body>'
```

Example prompt: Can you run a fuzzy sanctions screen on the name 'Ivan Petrov' and let me know if there are any matches on OFAC or UN lists, with a confidence threshold of 0.8?

## When to prefer this

Choose this endpoint when you need fast, offline, deterministic sanctions screening without relying on ML models or live web scraping. Ideal for compliance workflows where auditability matters (signed receipts, scope field, list_as_of date). Particularly suited for rental due diligence, vendor onboarding, or transaction screening where a per-call micropayment model fits and you need reproducible results. Prefer over live-data sanctions APIs when determinism and cost predictability matter more than real-time list updates.

## Known failure modes

- Invalid or missing entity name input returns an error
- Threshold parameter out of range (0-1) causes validation failure
- Sanctions list snapshot may be stale — list_as_of date should be checked
- Short or highly common names may produce false positives at low thresholds
- Service unavailable if daily free quota exceeded and payment not configured

## How this service works

Offline deterministic checks (no ML, no scraping) for business identifiers and rental due-diligence, paid per call via x402 (gasless EIP-3009 USDC on Base). Checksum-verifiable (IBAN, LEI, VAT, ABA, ISBN, SEDOL…) vs format-only (EIN, IFSC, SWIFT/BIC…) — every response returns a scope field. Non-custodial, signed receipts. First 3 calls/day free.

## Output

Returns a JSON object with: match_found (boolean), confidence (0-1 score), matches (array of matched entries), screened_count (number of records checked), list_as_of (date of sanctions list snapshot), jurisdiction_flag (relevant jurisdiction if matched), scope (indicates whether the check was checksum-verifiable or format-only), and a reason string explaining the result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "name"
   ],
   "properties": {
    "name": {
     "type": "string",
     "description": "Person, entity, or vessel name to screen (e.g. 'Lazarus Group')"
    },
    "program": {
     "type": "string",
     "description": "Optional OFAC program substring filter (e.g. 'CYBER2', 'DPRK')"
    },
    "threshold": {
     "type": "number",
     "description": "Optional minimum similarity 0.5–1.0 (default 0.85)"
    },
    "jurisdiction": {
     "type": "string",
     "description": "Optional ISO 3166-1 country code or jurisdiction name, returned as context flag"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "tool",
   "valid",
   "match_found",
   "confidence",
   "scope"
  ],
  "properties": {
   "tool": {
    "type": "string"
   },
   "scope": {
    "type": "string"
   },
   "valid": {
    "type": "boolean"
   },
   "reason": {
    "type": "string"
   },
   "matches": {
    "type": "array"
   },
   "threshold": {
    "type": "number"
   },
   "confidence": {
    "type": "number"
   },
   "list_as_of": {
    "type": "string"
   },
   "match_found": {
    "type": "boolean"
   },
   "screened_count": {
    "type": "number"
   },
   "jurisdiction_flag": {
    "type": "string"
   }
  }
 },
 "example": {
  "valid": true,
  "reason": "checksum valid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/code402-fuzzy-match-sanctions-30f3c510/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hcrb.in](https://www.zero.xyz/host/hcrb.in/llms.txt)
