{"uid":"cap_xwQP-OXNiiZfFsh8bQ8q-","slug":"halowerk-supplier-batch-check-4f5c0c6f","name":"HALOWERK Supplier Batch Check","description":"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…","url":"https://handel.halowerk.com/v1/supplier-batch-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zYG9WOpig1EYJtpQGpEMM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-onboarding vendor compliance screen","prompt":"Before we add these five new suppliers to our ERP, can you screen them all for sanctions exposure and check their EU VAT IDs? They're all German companies: Hetzner Online GmbH (DE), Müller Logistik AG (DE), and three others I'll paste — give me a red/yellow/green for each."},{"title":"Accounts payable invoice validation","prompt":"We just received invoices from three vendors and I need to make sure none of them are sanctioned and their VAT IDs are still valid before we process payment — the suppliers are Hetzner Online GmbH (DE, VAT DE812871812), BASF SE (DE, VAT DE811483782), and Zalando SE (DE). Can you check them?"},{"title":"Procurement due diligence on potential partner","prompt":"We're considering a new logistics partner called IRISL Europe GmbH based in Germany — can you check whether they appear on any sanctions lists and whether their LEI is active? I want to know the risk signal before we proceed."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:32:36.257Z","isFirstParty":false,"canonicalSlug":"halowerk-supplier-batch-check-4f5c0c6f"}