# EU VAT Number Validation via VIES

> EU VAT Number Validation via VIES is a paid API for AI agents from x402-endpoints.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-09).

Validates an EU VAT number against the official EU VIES registry, returning validity status plus registered company name and address for any of the 27 EU member states.

## Facts

- Endpoint: GET https://x402-endpoints.onrender.com/vies/vat?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-vat-number-validation-via-vies-a62ccb3f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tLghKiWAg2QW2_6Mp9RsD

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-a62ccb3f
```

Example prompt: Can you check whether the Irish VAT number 6388047V is valid? I need the registered company name and address too — it's for a supplier invoice.

## When to prefer this

Use this endpoint when you need to verify a European business's VAT registration status in real-time against the authoritative EU VIES registry, especially for B2B invoice compliance, supplier onboarding, or cross-border EU transactions. It correctly distinguishes between an invalid VAT number and a temporarily unavailable national database, which is critical for compliance workflows.

## Known failure modes

- VAT number does not exist in VIES — returns 'invalid' status
- National member state database temporarily offline — returns 'service unavailable' (distinguishable from invalid)
- Malformed country code or VAT number format — likely 400 bad request
- VIES central service outage — endpoint may return error
- Invalid 2-letter country code not matching EU member states

## How this service works

Validate an EU VAT number (tax identification number / TIN) against the official EU VIES registry across all 27 member states — returns valid/invalid plus the registered company name and address. Distinguishes 'invalid' (number does not exist) from 'service unavailable' (national DB offline).

## Output

Returns whether the VAT number is valid, invalid, or temporarily unavailable (national database offline), along with the registered legal company name and address associated with the VAT number if valid.

## 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": [
      "country",
      "vat"
     ],
     "properties": {
      "vat": {
       "type": "string",
       "description": "VAT number without country prefix, e.g. '6388047V'"
      },
      "country": {
       "type": "string",
       "pattern": "^[A-Z]{2}$",
       "description": "2-letter EU member state code, e.g. 'IE' ('EL' for Greece)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "GOOGLE IRELAND LIMITED",
  "valid": true,
  "cached": false,
  "source": "EU VIES REST API (ec.europa.eu)",
  "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "timestamp": "2026-06-24T14:17:13Z",
  "disclaimer": "Indicative data from the VIES register (EU Commission), not a compliance opinion.",
  "vat_number": "6388047V",
  "country_code": "IE",
  "request_date": "2026-06-24T14:17:13.066Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vat-number-validation-via-vies-a62ccb3f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-endpoints.onrender.com](https://www.zero.xyz/host/x402-endpoints.onrender.com/llms.txt)