# Fin Codes API – Sanctions Screening

> Fin Codes API – Sanctions Screening is a paid API for AI agents from api.fincodesapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Screens an individual, entity, vessel, or aircraft name against major global sanctions lists (OFAC SDN, EU, UN, UK, CH, AU, CA) and returns fuzzy-matched hits with scores, programs, and listed dates.

## Facts

- Endpoint: POST https://api.fincodesapi.com/x402/sanctions-screening?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fin-codes-api-sanctions-screening-ced799f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6Xc_uhFJiGNM5B5W8zU0c

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 fin-codes-api-sanctions-screening-ced799f6 -d '<json body>'
```

Example prompt: Screen 'Sadam Husein' as an INDIVIDUAL against the EU and OFAC SDN sanctions lists with a minimum match score of 90 and tell me if there are any hits.

## When to prefer this

Choose this endpoint when you need fuzzy-match sanctions screening across multiple authoritative global watchlists (OFAC SDN, EU, UN, UK, AU, CH, CA) in a single API call with configurable score thresholds. Prefer this over generic AML tools when you also need bank code or IBAN validation on the same platform, or when you need to screen vessels and aircraft in addition to individuals and entities.

## Known failure modes

- Name too short (under 2 characters) or over 255 characters returns a validation error
- min_score outside 70–100 range is rejected
- Invalid enum value for type or sources returns a 422 validation error
- Network timeout on POST may occur for very broad multi-list queries
- Typos in list source codes (e.g. 'OFAC' instead of 'OFAC_SDN') return an error or empty result

## How this service works

Validate IBANs, BIC/SWIFT codes and local bank routing codes worldwide with one REST API. ABA, BSB, IFSC, CLABE, NCC, Canadian routing numbers and more, plus payee verification and sanctions screening.

## Output

Returns a JSON object with the queried name, a list of matches (each including a UUID, the matched name, party type, fuzzy match score, the sanctions list source, applicable programs, date listed, birth dates if available, and source reference), and a success flag. An empty matches array means no hits were found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "example": "Sadam Husein",
   "maxLength": 255,
   "minLength": 2,
   "description": "Name to screen."
  },
  "type": {
   "enum": [
    "INDIVIDUAL",
    "ENTITY",
    "VESSEL",
    "AIRCRAFT"
   ],
   "type": "string",
   "example": "INDIVIDUAL",
   "description": "Only match parties of this type."
  },
  "sources": {
   "type": "array",
   "items": {
    "enum": [
     "EU",
     "UK",
     "UN",
     "OFAC_SDN",
     "OFAC_CONS",
     "CH",
     "AU",
     "CA"
    ],
    "type": "string"
   },
   "example": [
    "EU",
    "OFAC_SDN"
   ],
   "description": "Only screen against these sanctions lists. All lists by default."
  },
  "min_score": {
   "type": "integer",
   "default": 90,
   "example": 90,
   "maximum": 100,
   "minimum": 70,
   "description": "Minimum match score from 70 to 100."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "name": "Sadam Husein",
   "matches": [
    {
     "id": "ef947777-8b4c-4859-b07b-042be956bf4a",
     "name": "Saddam Hussein Al-Tikriti",
     "type": "INDIVIDUAL",
     "score": 90,
     "source": "EU",
     "programs": [
      "IRQ"
     ],
     "listed_on": "2003-07-08",
     "birth_dates": [
      "1937-04-28"
     ],
     "matched_name": "Saddam Hussein Al-Tikriti",
     "source_reference": "EU.27.28"
    }
   ]
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fin-codes-api-sanctions-screening-ced799f6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fincodesapi.com](https://www.zero.xyz/host/api.fincodesapi.com/llms.txt)