# EU VAT Number Validation API

> EU VAT Number Validation API is a paid API for AI agents from ats-jobs-api.groundtruthtools.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-01).

Validates a European VAT registration number against the EU VIES system and returns legal entity name, validity status, and attribution metadata.

## Facts

- Endpoint: GET https://ats-jobs-api.groundtruthtools.workers.dev/x402/v1/vat?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-vat-number-validation-api-ff1877f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HOGjoW-8qi_tFMi7JTiJo

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-api-ff1877f6
```

Example prompt: Can you verify that the VAT number CZ00177041 is valid and tell me the legal company name associated with it?

## When to prefer this

Use this endpoint when you need to validate EU VAT numbers directly against the authoritative VIES system, particularly when you need the registered legal name alongside validity status. Prefer this over generic tax APIs when you need CC BY 4.0 attributed EU-official data, structured numeric output, and a direct VIES verification link for audit trails.

## Known failure modes

- Invalid VAT format returns is_valid: false or an error
- VAT number not found in VIES returns is_valid: false
- VIES service temporarily unavailable causes upstream timeout
- Malformed VAT string (missing country prefix) may cause parsing error
- Some member states restrict real-time VIES lookups causing inconclusive results

## How this service works

Open job postings read first-hand from the applicant-tracking system behind a company's careers page: Greenhouse, Ashby, Lever or Workable. Includes a directory of 8532 company job boards, because none of the vendors publishes one. Salaries are parsed into numbers where the employer publishes them and refused where ambiguous. No personal data.

## Output

Returns a JSON object with: is_valid (boolean), legal_name (company name as registered), vat_number (normalized), country_code, check_status ('valid' or other), checked_date (ISO date), verify_url (VIES link), source ('vies'), source_country, and attribution noting CC BY 4.0 licensing. Returns null for check_note when no issues are found.

## 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": [
      "vat"
     ],
     "properties": {
      "vat": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "vies",
  "is_valid": true,
  "check_note": null,
  "legal_name": "Škoda Auto a.s.",
  "vat_number": "CZ00177041",
  "verify_url": "https://ec.europa.eu/taxation_customs/vies/#/vat-validation",
  "attribution": "Contains information from the European Commission VIES service, licensed under CC BY 4.0.",
  "check_status": "valid",
  "checked_date": "2026-10-30",
  "country_code": "CZ",
  "source_country": "CZ"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vat-number-validation-api-ff1877f6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ats-jobs-api.groundtruthtools.workers.dev](https://www.zero.xyz/host/ats-jobs-api.groundtruthtools.workers.dev/llms.txt)