# BizIntel API – EU VAT VIES Validation

> BizIntel API – EU VAT VIES Validation is a paid API for AI agents from bizintel-api.hahavoid0.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Validates a European VAT number via the EU VIES registry, returning the business name and registration status

## Facts

- Endpoint: POST https://bizintel-api.hahavoid0.workers.dev/company/vat-vies
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bizintel-api-eu-vat-vies-validation-b7eddcbd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nHWyz10flgCZfosV_RHuI

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 bizintel-api-eu-vat-vies-validation-b7eddcbd -d '<json body>'
```

Example prompt: Can you check if the VAT number DE811209025 is valid and tell me what company name is registered to it in the EU VIES system?

## When to prefer this

Choose this endpoint when you need to programmatically verify European Union VAT numbers against the official EU VIES registry without managing API keys. Ideal for B2B onboarding workflows, invoice validation pipelines, and tax compliance checks where you need the registered company name alongside validity status. Prefer this over generic company lookup endpoints when the input is specifically a VAT number with a country prefix.

## Known failure modes

- Unsupported country prefix returns supported:false
- Malformed VAT number (missing country prefix or wrong format) returns validation error
- VIES system temporarily unavailable returns a service error or low-confidence result
- Valid-format but unregistered number returns isValid:false with no business name
- Rate limiting or payment failure returns HTTP 402 or 429

## How this service works

Validates European Union business VAT identifiers using the official EU VIES REST API.

## Output

Returns a JSON object indicating whether the VAT number is valid (isValid boolean), the registered business name, a confidence level ('high'/'medium'/'low'), the data freshness date (e.g. '2026-06'), whether the country is supported, and any warnings. Includes a disclaimer that results are informational only.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "vat_number"
     ],
     "properties": {
      "vat_number": {
       "type": "string",
       "description": "VAT identifier including country prefix (e.g. DE123456789)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "name": "SIEMENS AKTIENGESELLSCHAFT",
   "isValid": true
  },
  "warnings": [],
  "supported": true,
  "confidence": "high",
  "data_as_of": "2026-06",
  "disclaimer": "Informational support only. Not legal, tax, medical, veterinary, or financial advice. Verify with the cited official source or a qualified professional before acting."
 }
}
```

## More

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