# Euroref VAT/Tax-ID Validation

> Euroref VAT/Tax-ID Validation is a paid API for AI agents from euroref.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Validates European VAT/tax ID numbers using official algorithmic rules, returning validity, normalised form, ID type, and failure reason

## Facts

- Endpoint: GET https://euroref.dev/v1/taxid/validate?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/euroref-vat-tax-id-validation-f8af3217
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_phUtSN7fBupbMtNeRvCdK

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 euroref-vat-tax-id-validation-f8af3217
```

Example prompt: Can you check whether the VAT number 'DE123456789' is valid for Germany? I need to know if it passes the official format and check-digit rules.

## When to prefer this

Use this endpoint when you need fast, offline algorithmic VAT/tax-ID validation for European countries without hitting a live government registry. It is ideal for input validation during onboarding, invoice processing, or compliance checks where latency and cost matter. Prefer this over live VIES lookups when you only need format and check-digit correctness rather than real-time registration status.

## Known failure modes

- Invalid or unsupported country code returns an error indicating the country is not in coverage
- Malformed or empty ID string returns a validation failure with a descriptive reason
- Country not yet supported returns a coverage error
- Network or payment failure (402) if USDC payment is not attached or fails
- Ambiguous or partial numbers may return a specific format failure reason

## How this service works

Tax-ID / VAT-number validation for European countries: valid/invalid, normalised form, id type and the reason it failed. Format plus the official check-digit algorithm where the tax authority publishes one; every rule cited to an official source with its date. Pure algorithmic, no registry lookup

## Output

Returns whether the submitted tax/VAT ID is valid or invalid for the specified European country, the normalised canonical form of the number, the detected ID type (e.g. VAT, TIN), and — on failure — a specific reason the number did not pass, with all rules sourced from official tax authority publications.

## 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": [
      "country",
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "The tax ID / VAT number as written (spaces, dots, dashes and the VAT country prefix are accepted)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 country code on this brand (see GET /v1/taxid/coverage)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/euroref-vat-tax-id-validation-f8af3217/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from euroref.dev](https://www.zero.xyz/host/euroref.dev/llms.txt)