# EU VAT Number Validation via VIES

> EU VAT Number Validation via VIES is a paid API for AI agents from api.axiomworks.co.uk, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-12).

Validates an EU VAT number against the official VIES system, returning validity status, registered business name, and address when available

## Facts

- Endpoint: GET https://api.axiomworks.co.uk/eu-vat?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-vat-number-validation-via-vies-1536c65c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2dKEuPhzEJdn9jpm0XR9J

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-1536c65c
```

Example prompt: Can you check whether the VAT number DE811197884 is valid and tell me what company name and address are registered against it?

## When to prefer this

Use this endpoint when you need quick, cheap ($0.01) EU VAT number validation against the authoritative VIES system — ideal for invoice processing, supplier onboarding, or B2B customer verification. Prefer this over manual lookups or unverified sources. For full business due diligence including registry, domain, and sanctions checks, use the sibling /kyb endpoint ($2).

## Known failure modes

- VAT number not found in VIES — returns valid: false with no name/address
- VIES system temporarily unavailable — may return a service error
- Invalid format for VAT number (wrong prefix or structure) — returns validation error
- Country code not recognized — EL must be used for Greece, not GR
- Network timeout to VIES backend — may require retry

## How this service works

Use this to validate an EU VAT number via official VIES: valid flag, registered name/address when available, requestDate. Input vat like DE123456789 or IE6388047V (or country+number; use EL for Greece). Cached 24h when valid. Example: {vat:"IE6388047V"}. $0.01. Related: Verify the whole business: /kyb $2 (VAT + registry + domain + sanctions + risk).

## Output

Returns a JSON object with: valid (boolean), registered business name (string or null), address preview (string or null), countryCode, vatNumber, requestDate, and source indicator. Valid results are cached for 24 hours. Full address lines are included in paid responses.

## 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",
     "anyOf": [
      {
       "required": [
        "vat"
       ]
      },
      {
       "required": [
        "country",
        "number"
       ]
      }
     ],
     "properties": {
      "vat": {
       "type": "string",
       "description": "EU VAT id with country prefix, e.g. DE123456789 or IE6388047V"
      },
      "number": {
       "type": "string",
       "description": "VAT number without country prefix"
      },
      "country": {
       "type": "string",
       "description": "Optional 2-letter country (EL for Greece) if number given separately"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "vat": {
       "type": "string"
      },
      "name": {
       "type": [
        "string",
        "null"
       ]
      },
      "valid": {
       "type": "boolean"
      },
      "source": {
       "type": "string"
      },
      "address": {
       "type": [
        "string",
        "null"
       ]
      },
      "vatNumber": {
       "type": "string"
      },
      "countryCode": {
       "type": "string"
      },
      "requestDate": {}
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "GOOGLE IRELAND LIMITED",
  "valid": true,
  "sample": "live",
  "omitted": [
   "full address lines"
  ],
  "paid_call": "https://api.axiomworks.co.uk/eu-vat?vat=IE6388047V",
  "truncated": true,
  "vatNumber": "6388047V",
  "countryCode": "IE",
  "address_preview": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "full_report_via": "x402 (USDC on Base, HTTP 402 → PAYMENT-SIGNATURE retry)",
  "full_report_price": "$0.01",
  "preview_remaining": 6
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vat-number-validation-via-vies-1536c65c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.axiomworks.co.uk](https://www.zero.xyz/host/api.axiomworks.co.uk/llms.txt)
