# EU VIES VAT Number Lookup

> EU VIES VAT Number Lookup is a paid API for AI agents from x402.tuancodes.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-24).

Validates and retrieves company details for a given EU VAT number using the official EU VIES system

## Facts

- Endpoint: HEAD https://x402.tuancodes.workers.dev/vies/%7Bvat%7D?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-vies-vat-number-lookup-e5c67f77
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fgWlN0qe4XPvP6XH1xaEB

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-vies-vat-number-lookup-e5c67f77 -d '<json body>'
```

Example prompt: Can you check whether VAT number CZ27074358 is valid in the EU VIES system and tell me the registered company name and address?

## When to prefer this

Choose this endpoint when you need authoritative, real-time EU VAT validation from the official VIES system with no AI inference or scraping involved. Ideal for B2B invoice compliance, supplier onboarding, and tax exemption verification where an official deterministic result is required. Particularly suited for Czech company lookups given the additional ARES data source. Prefer over generic company data APIs when you specifically need VAT validity confirmation rather than general business information.

## Known failure modes

- VAT number not found in VIES — returns not-found result, no charge applied
- Upstream VIES service timeout or 5xx error — request not charged
- Malformed VAT number format — may result in upstream rejection
- Country code not supported by EU VIES — lookup fails
- Transient VIES availability issues during peak EU business hours

## How this service works

Deterministic lookups from official public sources (ARES, EU VIES, Czech National Bank, GLEIF LEI index). No AI, no scraping. Pay per call in USDC on Base via x402. Requests that fail upstream (5xx/timeout) or not-found results are not charged.

## Output

Returns a JSON object with the company name, a boolean validity flag, the registered address, VAT number, country code, the official source (EU VIES), and the timestamp of the request. If the VAT number is not found or upstream fails, no charge is made.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Asseco Central Europe, a.s.",
  "valid": true,
  "source": "EU VIES (ec.europa.eu/taxation_customs/vies)",
  "address": "Budějovická 778/3a, PRAHA 4 - MICHLE, 140 00  PRAHA 4",
  "vat_number": "27074358",
  "country_code": "CZ",
  "request_date": "2026-10-13T21:48:52.880Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vies-vat-number-lookup-e5c67f77/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tuancodes.workers.dev](https://www.zero.xyz/host/x402.tuancodes.workers.dev/llms.txt)