# Aayat AI EU VAT Validator (VIES)

> Aayat AI EU VAT Validator (VIES) is a paid API for AI agents from aayatai.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Validates an EU VAT number live against the European Commission's VIES system and returns validity, registered company name, and address.

## Facts

- Endpoint: GET https://aayatai.com/eu/vat?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aayat-ai-eu-vat-validator-vies-ab018811
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u16pMJtGrxFJBO25iOKnv

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 aayat-ai-eu-vat-validator-vies-ab018811
```

Example prompt: Can you check whether the VAT number IE6388047V is valid and tell me the registered company name and address on file?

## When to prefer this

Use this endpoint when you need a live, authoritative check of an EU or Northern Ireland VAT number against the official VIES system — not a cached or third-party database. Prefer it for compliance workflows, supplier onboarding, invoice verification, or any context where real-time validity and official registered details matter. It is the right choice when you need the actual registered company name and address (where the member state shares them), not just a format check.

## Known failure modes

- VAT number format is invalid or missing country prefix — returns error or invalid result
- VIES system temporarily unavailable — upstream timeout or service disruption
- Member state does not share name/address — valid=true but name and address are null
- Sole trader VAT number — valid=true but name withheld, withheld=true
- Country code not in EU/XI — unsupported country prefix returns error

## How this service works

Check an EU VAT number live against the European Commission's VIES system: valid or not, and the registered company name and address where the member state shares them. Northern Ireland (XI) numbers included. Sole traders' names are withheld (personal data).

## Output

A JSON object containing: 'valid' (boolean), 'vatNumber' (the queried number), 'country' (2-letter country code), 'name' (registered company name or null), 'address' (registered address or null), 'withheld' (boolean, true if name was hidden for sole-trader privacy), 'source' (e.g. 'EU VIES'), and 'checkedAt' (ISO 8601 timestamp of the live check).

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "number"
     ],
     "properties": {
      "number": {
       "type": "string",
       "maxLength": 20,
       "description": "VAT number with its country prefix, e.g. DE811569869."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "valid",
      "country",
      "vatNumber",
      "source"
     ],
     "properties": {
      "name": {
       "type": [
        "string",
        "null"
       ],
       "description": "Registered name if the country shares it and it is a company."
      },
      "valid": {
       "type": "boolean"
      },
      "source": {
       "type": "string"
      },
      "address": {
       "type": [
        "string",
        "null"
       ]
      },
      "country": {
       "type": "string"
      },
      "withheld": {
       "type": "boolean",
       "description": "True when a name was hidden because it may belong to a sole trader."
      },
      "checkedAt": {
       "type": "string"
      },
      "vatNumber": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "GOOGLE IRELAND LIMITED",
  "valid": true,
  "source": "EU VIES",
  "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "country": "IE",
  "withheld": false,
  "checkedAt": "2026-09-28T09:00:00.000Z",
  "vatNumber": "IE6388047V"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-eu-vat-validator-vies-ab018811/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aayatai.com](https://www.zero.xyz/host/aayatai.com/llms.txt)