# Netzhandwerker EU VAT ID Validator

> Netzhandwerker EU VAT ID Validator is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10).

Validates a European VAT ID via the EU VIES system, returning company details, format checks, and optional name/website matching.

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/business/eu?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-eu-vat-id-validator-1241948d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tbCsgalu0W9QTuWyaUtY8

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-eu-vat-id-validator-1241948d -d '<json body>'
```

Example prompt: Can you validate the EU VAT ID DE123456789 and check whether it matches the company name 'Musterfirma GmbH'?

## When to prefer this

Use this endpoint when you need authoritative EU VAT ID validation via the official VIES system, especially when you also need normalized company data, checksum verification, fuzzy company-name matching, or impressum cross-checking — all in a single API call. Prefer this over generic VIES wrappers when your workflow involves agent automation with x402 micropayment rails, or when you need structured JSON output with verdict, legal form, and parsed address fields rather than raw VIES HTML responses.

## Known failure modes

- VIES service temporarily unavailable — EU VIES has known downtime windows; retry logic recommended
- Invalid VAT ID format — checksum or structure fails before VIES query
- VAT ID not found in VIES — number may be deregistered or belong to a non-VIES country
- Website impressum unreachable — website_match will return not_comparable fields
- Rate limits or payment failures — x402 micropayment must succeed before query is processed

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns a JSON object with: VIES lookup result (company name, address, validity, consultation timestamp), format and checksum validation flags, normalized company data (legal form, parsed address, country), an overall verdict string (e.g. 'bestaetigt'), and optional fuzzy name-match score against expected_name and website impressum comparison results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vat_id": {
   "type": "string",
   "description": "USt-IdNr. mit Länderpräfix, z. B. DE123456789. Leer- und Satzzeichen werden entfernt."
  },
  "website": {
   "type": "string",
   "description": "Optional. Website des Unternehmens; deren Impressum wird geholt und abgeglichen."
  },
  "expected_name": {
   "type": "string",
   "description": "Optional. Erwarteter Firmenname für einen unscharfen Vergleich mit dem VIES-Namen."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "vies": {
   "name": "AMAZON EU SARL",
   "valid": true,
   "address": "38, AVENUE JOHN F. KENNEDY\nL-1855  LUXEMBOURG",
   "request_id": null,
   "consulted_on": "2026-08-06T11:39:27.223Z",
   "name_disclosure": true
  },
  "format": {
   "country_code": "LU",
   "checksum_valid": true,
   "country_prefix": "LU",
   "structure_valid": true,
   "checksum_supported": true
  },
  "vat_id": "LU20260743",
  "hinweis": "Auskunft aus dem VIES-Dienst der EU-Kommission, keine steuerliche Bestaetigung.",
  "verdict": "bestaetigt",
  "normalized": {
   "vat_id": "LU20260743",
   "address": {
    "city": "LUXEMBOURG",
    "street": "AVENUE JOHN F. KENNEDY",
    "postcode": "1855",
    "country_code": "LU",
    "house_number": "38"
   },
   "legal_form": "SARL",
   "company_name": "AMAZON EU",
   "country_code": "LU"
  },
  "format_valid": true,
  "website_match": {
   "checked": false,
   "vat_match": null,
   "name_match": null,
   "address_match": null,
   "discrepancies": [],
   "not_comparable": []
  },
  "expected_name_match": {
   "verdict": "gleich",
   "comparable": true,
   "similarity": 1,
   "compared_with": "AMAZON EU SARL",
   "expected_name": "Amazon EU S.à r.l."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-eu-vat-id-validator-1241948d/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)