# EU VAT Number Validation (VIES)

> EU VAT Number Validation (VIES) is a paid API for AI agents from agentdata-api.sander-van-aard.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Validates EU VAT numbers against the European Commission's VIES service, with both cached fast mode and live consultation-proof mode returning official consultation numbers.

## Facts

- Endpoint: POST https://agentdata-api.sander-van-aard.workers.dev/eu/vat
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-vat-number-validation-vies-28f23d9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N-nm-Z2r6UM0ZvvZ_rxd8

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-vies-28f23d9e -d '<json body>'
```

Example prompt: Can you verify whether EU VAT number DE123456789 is valid? I need the official VIES consultation number for our records, so please use the live consultation-proof mode with our company name as the requester.

## When to prefer this

Use this endpoint when you need to validate EU VAT numbers for B2B invoicing, supplier onboarding, or compliance audits. Choose fast mode when a recent cached result is acceptable; choose consultation-proof mode when you need an official VIES consultation number for audit trails or tax authority submissions. Prefer this over scraping VIES directly because it provides machine-readable errors, per-member-state availability signals, and predictable agent-friendly behavior including labeled cache timestamps.

## Known failure modes

- Member state VIES endpoint unavailable — returns per-country availability status rather than a validation result
- Invalid VAT number format — returns machine-readable format error
- VIES service temporarily down — returns error with availability metadata
- Missing requester identification in consultation-proof mode — validation rejected
- Network timeout to upstream VIES — returns error with retry guidance

## How this service works

EU VAT number validation (VIES) with predictable behavior for agents. Validates any EU VAT number against the European Commission's VIES service. Two modes: fast validation (may serve a cached result, labeled with its timestamp) and consultation-proof mode (always live, returns the official consultation number, requires requester identification). 'Not confirmed' does not imply the company is invalid. Machine-readable errors with per-member-state availability status.

## Output

Returns validation status (confirmed/not confirmed), company name and address if available, the consultation number (in live mode), a cache timestamp (in fast mode), and per-member-state availability status if the VIES service for that country is down. Machine-readable errors indicate when a specific member state's VIES endpoint is unavailable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vat-number-validation-vies-28f23d9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdata-api.sander-van-aard.workers.dev](https://www.zero.xyz/host/agentdata-api.sander-van-aard.workers.dev/llms.txt)