# Z2R Agent API — EU VAT Validation (VIES)

> Z2R Agent API — EU VAT Validation (VIES) is a paid API for AI agents from z2r-agent-api.netlify.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10).

Validates a European VAT number against the official EU VIES system, returning validity status, registered business name, and address.

## Facts

- Endpoint: GET https://z2r-agent-api.netlify.app/api/vat?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/z2r-agent-api-eu-vat-validation-vies-9c847c5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3yC4XKtY6dMT41Jw5Mkt5

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 z2r-agent-api-eu-vat-validation-vies-9c847c5b
```

Example prompt: Can you check if the Italian VAT number 12345678901 is valid and tell me the registered business name and address?

## When to prefer this

Choose this endpoint when you need real-time, programmatic EU VAT validation directly against the official VIES database, especially in agentic or automated workflows where per-call micropayment via USDC on Base is acceptable. Prefer it over manual VIES web lookups or batch validation services when you need a structured JSON response suitable for downstream processing without building your own VIES integration.

## Known failure modes

- Invalid or malformed VAT number format returns valid: false
- VIES service temporarily unavailable may return an error or degraded response
- Unsupported or non-EU country code returns an error
- Payment failure via x402 prevents the call from completing
- VAT number exists but VIES returns no name/address (null fields) for some member states

## How this service works

Pay-per-call APIs for AI agents: EU VAT validation (VIES) and website SEO/compliance check. USDC on Base via x402.

## Output

A JSON object containing: 'valid' (boolean indicating VIES registration status), 'name' (registered business name or null), 'address' (registered address or null), 'checksumOk' (boolean or null for local checksum validity), and 'source' (string indicating the data source used).

## Request schema (JSON Schema)

```json
{
 "input": {
  "type": "object",
  "required": [
   "country",
   "number"
  ],
  "properties": {
   "number": {
    "type": "string",
    "description": "VAT number without country prefix"
   },
   "country": {
    "type": "string",
    "description": "2-letter EU country code, e.g. IT, DE, FR"
   }
  }
 },
 "output": {
  "type": "object"
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "string|null",
  "valid": "boolean",
  "source": "string",
  "address": "string|null",
  "checksumOk": "boolean|null"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/z2r-agent-api-eu-vat-validation-vies-9c847c5b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from z2r-agent-api.netlify.app](https://www.zero.xyz/host/z2r-agent-api.netlify.app/llms.txt)