# HALOWERK Sanctions Check

> HALOWERK Sanctions Check is a paid API for AI agents from handel.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Checks a person or entity name against international sanctions lists to determine if they are sanctioned.

## Facts

- Endpoint: POST https://handel.halowerk.com/v1/sanctions-check
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-sanctions-check-ea90ff07
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lBiUe7dmp8PFI4eb5RV0D

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 halowerk-sanctions-check-ea90ff07 -d '<json body>'
```

Example prompt: Can you run a sanctions check on 'Acme Trading GmbH' — I need to know if they appear on any international sanctions lists before we proceed with the contract?

## When to prefer this

Use this endpoint when you need a quick, pay-per-call sanctions screening without maintaining a subscription to a full compliance database. Ideal for low-to-medium volume checks, ad-hoc counterparty screening, or when building lightweight AML compliance flows. Best suited for trade, e-commerce, or procurement contexts where you need to verify a business partner, supplier, or customer before transacting.

## Known failure modes

- Name too ambiguous or common — may return multiple partial matches requiring manual review
- Entity not found — returns no match (does not guarantee the entity is safe, only not listed)
- Input name malformed or empty — returns validation error
- Downstream sanctions database temporarily unavailable — may return service error
- Payment failure via x402 — request not processed

## How this service works

HALOWERK handelswerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.

## Output

Returns whether the queried name or entity matches any entry on international sanctions lists, along with details of any matches found including the list name, matched entity, and risk verdict.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2,
   "description": "Person or company name to screen, e.g. \"Ivan Petrov\" or \"Example Trading LLC\"."
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1
  },
  "match": {
   "enum": [
    "exact",
    "all_words",
    "partial"
   ],
   "type": "string",
   "default": "all_words",
   "description": "exact = normalised string equality. all_words = every significant word of the query appears in the alias. partial = at least one significant word, widest and noisiest."
  },
  "programme": {
   "type": "string",
   "maxLength": 20,
   "description": "Restrict to a sanctions programme code, e.g. \"RUS\", \"IRQ\", \"SYR\"."
  },
  "subject_type": {
   "enum": [
    "any",
    "person",
    "enterprise"
   ],
   "type": "string",
   "default": "any",
   "description": "Restrict to natural persons or to entities."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-sanctions-check-ea90ff07/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from handel.halowerk.com](https://www.zero.xyz/host/handel.halowerk.com/llms.txt)