# EU VAT Number VIES Validation

> EU VAT Number VIES Validation is a paid API for AI agents from agent-api-production.tim1712.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Validates an EU VAT number against the official European Commission VIES REST API and returns current validity status, registered company name, and address.

## Facts

- Endpoint: POST https://agent-api-production.tim1712.workers.dev/v1/business/eu-vat-check
- Price: $0.01/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-vies-validation-0dc07d76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KQ3T-PkjnwseguHwrfzMP

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-vies-validation-0dc07d76 -d '<json body>'
```

Example prompt: Can you check if VAT number NL123456789B01 is currently valid on VIES? I need the registered company name and address before I onboard them as a supplier.

## When to prefer this

Use this endpoint when you need a real-time, official VIES validation of an EU or Northern Ireland (XI) VAT number before B2B onboarding, invoicing, or procurement. Prefer this over third-party VAT databases when you need the authoritative live status from the European Commission's own system. Not suitable for sanctions screening, KYC/AML checks, or formal tax compliance certificates.

## Known failure modes

- VIES service temporarily unavailable for a specific member state — returns a warning or error indicating the national system is down
- Invalid country code supplied — returns a validation error
- VAT number format does not match the expected format for the country — may return invalid or an error
- Member state does not return name/address — valid status returned but name and address fields are empty
- Network timeout to VIES REST API — returns an error response

## How this service works

Use when an agent needs the current official VIES validation status of an EU VAT number before B2B onboarding, invoicing or procurement. Queries the European Commission VIES REST API and returns whether the number is currently valid, plus the registered company name and address when the member state returns them. It does not give tax advice and is not proof a company is legitimate, an invoice is compliant, or a sanctions/KYC/AML check.

## Output

A JSON object containing: whether the VAT number is currently valid (boolean), the registered company name and address (when the member state returns them), the source ('eu-vies'), the VAT number and country code echoed back, the timestamp the check was performed, the VIES request date, and any warnings (e.g. when name/address are unavailable).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vatNumber": {
   "type": "string",
   "maxLength": 24,
   "minLength": 1
  },
  "countryCode": {
   "enum": [
    "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"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "EXAMPLE HOLDING B.V.",
  "valid": true,
  "source": "eu-vies",
  "address": "EXAMPLESTRAAT 1\n1234 AB AMSTERDAM",
  "warnings": [],
  "checkedAt": "2026-08-30T10:00:02.000Z",
  "vatNumber": "123456789B01",
  "countryCode": "NL",
  "requestDate": "2026-08-30T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vat-number-vies-validation-0dc07d76/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-api-production.tim1712.workers.dev](https://www.zero.xyz/host/agent-api-production.tim1712.workers.dev/llms.txt)