# SYNTHORA vatcheck

> SYNTHORA vatcheck is a paid API for AI agents from vatcheck.hergertsynthora.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-13).

Validates EU VAT numbers in real-time via the official European Commission VIES SOAP service, returning validity status, registered trader name and address, with optional fiscal-context digest from BOE and EUR-Lex.

## Facts

- Endpoint: POST https://vatcheck.hergertsynthora.com/service?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-vatcheck-9749264f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k5d-z-ROY9_sMLrofr37P

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 synthora-vatcheck-9749264f -d '<json body>'
```

Example prompt: Can you verify whether the VAT number IE6388047V is valid and get me the registered company name and address? Include the fiscal context bundle too.

## When to prefer this

Choose this endpoint when you need authoritative, real-time EU VAT validation directly from the European Commission VIES service — not a cached or third-party database. Particularly suited for compliance-critical workflows, B2B onboarding, pre-invoice validation, or when you need the official registered trader name and address. The optional BOE/EUR-Lex fiscal context bundle adds value for Spanish or EU-regulation-aware compliance agents. Covers all EU member states including Greece (EL prefix) and Northern Ireland (XI prefix).

## Known failure modes

- Invalid or malformed VAT number format returns ok:false with error detail
- VAT number not found in VIES returns valid:false
- VIES upstream unavailable returns error with no charge applied
- Unsupported country prefix returns validation error
- Network timeout from EC VIES SOAP service may cause delayed or failed response

## How this service works

EU VAT validation against the European Commission VIES service (official SOAP checkVat, real-time): validity, registered trader name & address for any EU VAT id (EL Greece, XI Northern Ireland included). Optional fiscal-context bundle from BOE (Spain official gazette) and EUR-Lex (EU law) intel feeds. Built for compliance, invoicing and B2B-onboarding agents. $0.02 USDC via x402 on Base. SYNTHORA. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

A JSON object indicating whether the VAT number is valid, the registered trader name and address, country code, and request date from the VIES service. Optionally includes a fiscal_context bundle with recent BOE (Spain official gazette) and EUR-Lex (EU law) digest items. Also returns provenance metadata including cache status, fetch timestamp, latency, and data sources used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vat_number": {
   "type": "string",
   "description": "EU VAT id with country prefix, e.g. IE6388047V (EL=Greece, XI=Northern Ireland)"
  },
  "include_bundle": {
   "type": "boolean",
   "description": "attach BOE/EUR-Lex fiscal digest (default true)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "vat_check",
  "result": {
   "vat": {
    "valid": true,
    "vat_number": "6388047V",
    "trader_name": "GOOGLE IRELAND LIMITED",
    "country_code": "IE",
    "request_date": "2026-08-11+02:00",
    "trader_address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4"
   },
   "summary": "IE6388047V VÁLIDO — GOOGLE IRELAND LIMITED",
   "fiscal_context": {
    "boe": {
     "feed": "boe",
     "items": [],
     "status": "ok"
    },
    "eurlex": {
     "feed": "eurlex",
     "items": [],
     "status": "ok"
    }
   }
  },
  "provenance": {
   "cache": "miss",
   "fetched_at": 1786450000,
   "latency_ms": 210,
   "data_sources": [
    "ec.europa.eu VIES checkVat (SOAP, oficial CE)",
    "intel_gov_boe.json",
    "intel_gov_eurlex.json"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-vatcheck-9749264f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vatcheck.hergertsynthora.com](https://www.zero.xyz/host/vatcheck.hergertsynthora.com/llms.txt)