# EU VAT Number Validation via VIES

> EU VAT Number Validation via VIES is a paid API for AI agents from nordata.hihat.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-30).

Validates an EU VAT identification number against the European Commission's official VIES service and returns validity status, registered name, and address.

## Facts

- Endpoint: GET https://nordata.hihat.workers.dev/mva?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-vat-number-validation-via-vies-492d7f14
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8TAmAUWYiDvmBrpcgmZ4l

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 eu-vat-number-validation-via-vies-492d7f14
```

Example prompt: Can you check whether the VAT number IE6388047V is valid for intra-EU trade and tell me the registered business name and address on file?

## When to prefer this

Use this endpoint when you need a live authoritative validation of an EU VAT number against each member state's national register via VIES — ideal for B2B invoicing, reverse-charge VAT compliance, KYB onboarding, or supplier data hygiene. Covers all 27 EU member states plus Northern Ireland (XI). Do not use for Norwegian companies (NO), UK (GB) or Swiss companies — for Norwegian entities use the /firma endpoint on the same host.

## Known failure modes

- VAT number format is invalid or unrecognized prefix — returns gyldig: false or error
- VIES service for the queried member state is temporarily unavailable — returns error or timeout
- Country prefix is not one of the 27 EU states or XI (e.g. NO, GB, CH) — not supported by this endpoint
- VAT number exists but member state does not disclose name/address — returns gyldig: true with empty navn/adresse
- Malformed or missing vat query parameter — returns 4xx error

## How this service works

EU VAT number validation against the European Commission's official VIES service, a live query of the issuing member state's national VAT register. Give a VAT id with country prefix (27 EU states plus XI) and get whether it is valid for intra-EU trade, plus registered name and address where the state discloses them. Use it for B2B invoicing and reverse-charge checks, customer onboarding/KYB and supplier data cleaning. Norway is not in VIES: use /firma.

## Output

Returns a JSON object with fields: vat (normalized VAT number), land (country code), navn (registered business name if disclosed by member state), adresse (registered address if disclosed), gyldig (boolean validity flag), kilde (data source), hentet (retrieval timestamp), sjekket (checked timestamp), and nummer (number portion).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "vat"
     ],
     "properties": {
      "vat": {
       "type": "string",
       "description": "EU VAT identification number with its 2-letter country prefix, e.g. IE6388047V, NL810433941B01 or SE556036079301. Lowercase, spaces, dots and dashes are accepted and normalised; GR is mapped to EL. Prefixes: AT BE BG CY CZ DE DK EE EL ES FI FR HR HU IE IT LT LU LV MT NL PL PT RO SE SI SK XI (Northern Ireland). Norway (NO), the UK (GB) and Switzerland are not in VIES."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "type": "object",
     "properties": {
      "vat": {
       "type": "string"
      },
      "land": {
       "type": "string"
      },
      "navn": {
       "type": "string"
      },
      "kilde": {
       "type": "string"
      },
      "gyldig": {
       "type": "boolean"
      },
      "hentet": {
       "type": "string"
      },
      "nummer": {
       "type": "string"
      },
      "adresse": {
       "type": "string"
      },
      "sjekket": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vat-number-validation-via-vies-492d7f14/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nordata.hihat.workers.dev](https://www.zero.xyz/host/nordata.hihat.workers.dev/llms.txt)