# Netzhandwerker Sanctions Screening

> Netzhandwerker Sanctions Screening is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-12).

Screens a person or organisation name against major international sanctions lists (EU, UN, OFAC, UK, SECO) and returns match results with similarity scores.

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/sanctions/screen?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-sanctions-screening-21032e1b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_egSoWj5S2NGltdCUQ8Kfz

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 netzhandwerker-sanctions-screening-21032e1b -d '<json body>'
```

Example prompt: Screen 'Acme Trading GmbH' as an organisation against the EU, OFAC, and UN sanctions lists and tell me if there are any matches — use a threshold of 0.8 and include up to 20 results.

## When to prefer this

Choose this endpoint when you need a fast, pay-per-call sanctions screening against multiple official lists (EU, UN, OFAC, UK, SECO) without a subscription. It is well suited for agent workflows that perform on-demand KYC or AML checks, for example during customer onboarding, vendor vetting, or pre-transaction compliance checks. Prefer it over batch screening APIs when checking individual names in real time.

## Known failure modes

- Name too long (exceeds 200 character limit)
- Threshold out of range (must be between 0.4 and 1.0)
- Limit exceeds maximum of 50
- Invalid list enum value (must be EU, UN, OFAC, UK, or SECO)
- Invalid entity type enum (must be 'person' or 'organisation')
- Invalid two-letter country code
- Payment not completed (x402 payment required)
- Network timeout for large candidate sets

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns a JSON object containing: a boolean hit flag, a human-readable verdict (e.g. 'treffer_pruefen'), a normalized query name, the number of matches found, a strong_match flag, dataset statistics (total names, entities, per-list counts, build timestamp), applied filters, lists checked, and an array of match objects each containing the sanctions list name, list ID, match score, character and token similarity, matched name, known aliases, listed date, associated programs and countries, birth date, and whether country/birth year filters matched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "maxLength": 200,
   "description": "Personen- oder Firmenname"
  },
  "type": {
   "enum": [
    "person",
    "organisation"
   ],
   "type": "string",
   "description": "Art einschraenken"
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 50
  },
  "lists": {
   "type": "array",
   "items": {
    "enum": [
     "EU",
     "UN",
     "OFAC",
     "UK",
     "SECO"
    ],
    "type": "string"
   }
  },
  "country": {
   "type": "string",
   "description": "Zweistelliger Laendercode als zusaetzliches Merkmal"
  },
  "threshold": {
   "type": "number",
   "default": 0.75,
   "maximum": 1,
   "minimum": 0.4
  },
  "birth_year": {
   "type": "string",
   "description": "Geburtsjahr als zusaetzliches Merkmal"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hit": true,
  "note": "Ein Treffer ist ein Pruefanlass, keine Feststellung der Identitaet.",
  "query": "Vladimir Putin",
  "dataset": {
   "names": 116661,
   "built_at": "2026-08-09T10:24:00Z",
   "entities": 48653,
   "per_list": {
    "EU": 6234,
    "UK": 5135,
    "UN": 1011,
    "OFAC": 19199,
    "SECO": 17074
   }
  },
  "filters": {
   "type": "person",
   "country": null,
   "birth_year": null
  },
  "matches": [
   {
    "list": "EU",
    "birth": "1952-10-07",
    "score": 1,
    "list_id": "EU.1234.56",
    "remarks": "President of the Russian Federation",
    "programs": "UKR",
    "countries": "RU",
    "listed_on": "2022-02-23",
    "entity_type": "person",
    "known_names": [
     "Vladimir PUTIN",
     "Vladimir Vladimirovich PUTIN"
    ],
    "matched_name": "Vladimir PUTIN",
    "country_match": null,
    "birth_year_match": null,
    "token_similarity": 1,
    "matched_name_kind": "primaer",
    "character_similarity": 1
   }
  ],
  "verdict": "treffer_pruefen",
  "threshold": 0.8,
  "normalized": "VLADIMIR PUTIN",
  "match_count": 5,
  "strong_match": true,
  "lists_checked": [
   "EU",
   "UN",
   "OFAC",
   "UK",
   "SECO"
  ],
  "candidates_examined": 412
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-sanctions-screening-21032e1b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.netzhandwerker.de](https://www.zero.xyz/host/tools.netzhandwerker.de/llms.txt)