# EU VAT Number Validation via VIES

> EU VAT Number Validation via VIES is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Validates EU VAT numbers in real-time against the European Commission VIES registry, returning validity status and a compliance timestamp

## Facts

- Endpoint: GET https://data.greeneris.io/v1/eu/vat-check
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-vat-number-validation-via-vies-0fd2b1a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Kyy6bvCjpYHHUk7CSFgLM

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-0fd2b1a2
```

Example prompt: Can you check whether this Irish VAT number is valid — member state IE, number 6388047V — I need to confirm before we issue an invoice?

## When to prefer this

Use this endpoint when you need real-time EU VAT number validation backed by the official European Commission VIES registry, especially for B2B invoicing compliance, supplier onboarding, or intra-EU transactions. Prefer over manual checks or third-party scrapers when you need an authoritative compliance timestamp. Best for single VAT lookups across all EU member states including EL (Greece) and XI (Northern Ireland).

## Known failure modes

- Invalid or unsupported member state code returns an error
- VAT number format mismatch for the given country may trigger user_error
- Member state registry temporarily unavailable may return error or stale cache
- Missing required query parameters cc or vat returns a bad request error
- Non-EU or unsupported country code returns an error

## How this service works

Live intra-EU VAT number validation via the European Commission VIES REST API (real-time query of the member state registry). Query: ?cc=IE&vat=6388047V (cc = member state code incl. EL/XI, vat = number without country prefix). Returns is_valid, the trader name and address as registered (when the member state publishes them) and request_date (compliance timestamp); 24h cache.

## Output

Returns a JSON object with is_valid (boolean indicating whether the VAT number is registered and active), request_date (timestamp of the check for compliance record-keeping), and user_error (any error message from the member state registry). Results are cached for 24 hours.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "cc",
      "vat"
     ],
     "properties": {
      "cc": {
       "type": "string",
       "description": "EU member state code (2 letters, e.g. IE, FR, EL, XI)"
      },
      "vat": {
       "type": "string",
       "description": "VAT number without the country prefix"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "VIES REST API (European Commission, DG TAXUD) -- live check against the member state registry",
  "is_valid": true,
  "user_error": "VALID",
  "vat_number": "6388047V",
  "country_code": "IE",
  "request_date": "2026-07-13T08:42:27.241Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vat-number-validation-via-vies-0fd2b1a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)