# HALOWERK Supplier Batch Check

> HALOWERK Supplier Batch Check is a paid API for AI agents from handel.halowerk.com, paid per call via x402, $0.5/call, status unknown (last checked 2026-11-16).

Screens up to 50 suppliers per batch for sanctions matches, VAT validity, LEI status, and domain signals, returning a traffic-light risk signal for each.

## Facts

- Endpoint: POST https://handel.halowerk.com/v1/supplier-batch-check?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-supplier-batch-check-4f5c0c6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xwQP-OXNiiZfFsh8bQ8q-

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-supplier-batch-check-4f5c0c6f -d '<json body>'
```

Example prompt: Can you run a sanctions and VAT check on these two German suppliers — Hetzner Online GmbH (VAT DE812871812, domain hetzner.com) and IRISL Europe GmbH — and tell me which ones come back red, yellow, or green?

## When to prefer this

Use this endpoint when you need to screen multiple suppliers in a single API call (up to 50) and want a combined view of sanctions exposure, VAT validity, LEI status, and domain hygiene at a flat per-batch price. Prefer this over manual VIES, GLEIF, or sanctions list lookups when you need a consolidated risk signal quickly during procurement, onboarding, or accounts payable workflows. Best suited for B2B trade compliance automation where EU suppliers and international sanctioned entities are the primary concern.

## Known failure modes

- Supplier name too short or missing country code returns validation error
- LEI lookup may time out if GLEIF is slow, reflected in duration_ms and completed_within_budget flag
- VAT ID check may fail if VIES is unavailable — status will indicate not checked rather than valid/invalid
- Sanctions match marked as 'possible' or 'strong' does not confirm actual sanctioning — manual review required
- Batch exceeding 50 suppliers is rejected with a schema validation error
- Payment failure via x402 results in HTTP 402 before any screening is performed

## How this service works

Batch supplier due-diligence triage for procurement and onboarding agents. For every supplier it screens the name against the EU consolidated financial sanctions list, the US OFAC SDN list and the UK Sanctions List (entity designations, UN-derived entries flagged), with a match quality of strong, medium or weak; validates the VAT ID live against VIES (valid, invalid or not checkable); looks up the LEI at GLEIF (registration status, registration country, last update) and checks the domain for…

## Output

Returns a per-supplier object with: a traffic-light signal (green/yellow/red) with reasoning, sanctions screening result (match count, matched list, programme, and quality), VAT ID validation via VIES, LEI lookup via GLEIF with entity and registration status, domain DNS checks (MX, SPF, DMARC), and a natural-person suspicion flag. Also returns a batch summary with counts by signal color, total duration, and pricing metadata. Includes a disclaimer that results are triage aids, not legal clearance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "suppliers": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "country"
    ],
    "properties": {
     "lei": {
      "type": "string",
      "maxLength": 20,
      "minLength": 20,
      "description": "Optional LEI, looked up at GLEIF."
     },
     "ref": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional reference, echoed back."
     },
     "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "Company name with legal form, e.g. \"Hetzner Online GmbH\"."
     },
     "domain": {
      "type": "string",
      "maxLength": 253,
      "minLength": 4,
      "description": "Optional domain; DNS only."
     },
     "vat_id": {
      "type": "string",
      "maxLength": 20,
      "minLength": 4,
      "description": "Optional EU VAT ID, checked live at VIES."
     },
     "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO country code, e.g. DE."
     }
    },
    "additionalProperties": false
   },
   "maxItems": 50,
   "minItems": 1,
   "description": "1 to 50 suppliers per batch; flat 0.50 USDC per batch."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "batch": {
   "count": 2,
   "lights": {
    "red": 1,
    "green": 1,
    "yellow": 0
   },
   "duration_ms": 412,
   "price_basis": {
    "unit": "batch",
    "suppliers": 2,
    "price_usdc": "0.50"
   },
   "time_budget_ms": 7000,
   "completed_within_budget": true
  },
  "suppliers": [
   {
    "lei": {
     "lei": "391200XMWUW8G8MXV439",
     "status": "found",
     "entity_status": "ACTIVE",
     "name_matches_input": "observed",
     "registration_status": "ISSUED"
    },
    "ref": null,
    "vat": {
     "status": "valid",
     "vat_id": "DE812871812",
     "country_matches_supplier": "observed"
    },
    "name": "Hetzner Online GmbH",
    "index": 0,
    "domain": {
     "mx": "observed",
     "spf": "observed",
     "dmarc": "observed",
     "domain": "hetzner.com",
     "status": "checked",
     "dmarc_policy": "reject"
    },
    "signal": {
     "light": "green",
     "meaning": "no flag in the checks performed; this is not a clearance",
     "reasons": []
    },
    "country": "DE",
    "sanctions": {
     "status": "no_match",
     "match_count": 0
    },
    "natural_person_suspected": false
   },
   {
    "lei": {
     "status": "not_provided"
    },
    "ref": null,
    "vat": {
     "status": "not_provided"
    },
    "name": "IRISL Europe GmbH",
    "index": 1,
    "domain": {
     "status": "not_provided"
    },
    "signal": {
     "light": "red",
     "reasons": [
      "sanctions: strong name match on EU (EU.13680.95) - manual review required"
     ]
    },
    "country": "DE",
    "sanctions": {
     "status": "possible_match",
     "matches": [
      {
       "list": "EU",
       "quality": "strong",
       "programme": "IRN",
       "reference": "EU.13680.95",
       "matched_name": "IRISL Europe GmbH"
      }
     ],
     "match_count": 1,
     "best_quality": "strong"
    },
    "natural_person_suspected": false
   }
  ],
  "disclaimer": "Triage aid built from public sources. Not a sanctions clearance, not a compliance or credit decision, not legal or tax advice."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-supplier-batch-check-4f5c0c6f/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)
