# LION VAT Validation (x402 Keyless)

> LION VAT Validation (x402 Keyless) is a paid API for AI agents from lion-x402.lionmaster-operations.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Validates a VAT number and returns company name, address, country, and confidence score — no API key required, paid per-call in USDC via x402.

## Facts

- Endpoint: GET https://lion-x402.lionmaster-operations.workers.dev/api/x402/vat-validation-json
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lion-vat-validation-x402-keyless-1c33de20
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_haTtzOjwOGjd6V3EQKMvi

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 lion-vat-validation-x402-keyless-1c33de20
```

Example prompt: Can you validate the VAT number IE6388047V for me and confirm the registered company name and address?

## When to prefer this

Use this endpoint when you need programmatic, per-call VAT number validation without managing API keys or subscriptions. Ideal for AI agents that need to verify supplier or customer VAT numbers during invoice processing, onboarding, or compliance checks, and can pay micro-fees in USDC via x402.

## Known failure modes

- Invalid or malformed VAT number format — returns valid: false or error response
- VAT number not found in registry — resolved: false, confidence: 0
- Payment not provided or insufficient — returns HTTP 402 with payment details
- Country code not supported — endpoint may return error or unresolved result
- Network timeout from upstream VAT registry — may return error or stale data

## How this service works

Keyless off-chain and on-chain data for AI agents. No API key, no signup - payment is the only gate. Pay-per-call in USDC on Base via x402.

## Output

Returns a JSON object with: valid (boolean), resolved (boolean), confidence (0–1), company_name, address, vat_number, country_code, as_of date, and request_date. Also includes an asset_id for tracking.

## 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",
     "properties": {
      "vat": {
       "type": "string",
       "description": "Full EU VAT e.g. IE6388047V"
      },
      "number": {
       "type": "string"
      },
      "country": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-03T00:00:00.000Z",
  "valid": true,
  "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "asset_id": "LION_VAT_VALIDATION_001",
  "resolved": true,
  "confidence": 1,
  "vat_number": "IE6388047V",
  "company_name": "GOOGLE IRELAND LIMITED",
  "country_code": "IE",
  "request_date": "2026-06-03T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lion-vat-validation-x402-keyless-1c33de20/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lion-x402.lionmaster-operations.workers.dev](https://www.zero.xyz/host/lion-x402.lionmaster-operations.workers.dev/llms.txt)