# EU VAT Number Validation

> EU VAT Number Validation is a paid API for AI agents from api.helpmyagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-17).

Validates a European Union VAT number via the VIES system and returns company name, address, and validity status

## Facts

- Endpoint: POST https://api.helpmyagent.com/v1/vat/eu/validate?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-vat-number-validation-1225b929
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_USZiAjYbtOLaIMAZWbG8k

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-1225b929 -d '<json body>'
```

Example prompt: Can you check if the VAT number FR39356000000 is valid and get me the registered company name and address?

## When to prefer this

Use this endpoint when you need real-time EU VAT number validation against the official VIES registry, especially for invoicing compliance, B2B customer onboarding, or supplier verification workflows. Prefer this over manual VIES lookups when you need programmatic, agent-callable verification with structured JSON output. It is well-suited for agentic workflows where VAT validation is a step in a larger automation (e.g. invoice generation, procurement, KYB pipelines).

## Known failure modes

- VIES service unavailable — status field returns 'unavailable' with null name/address/valid fields
- Invalid VAT number format — may return valid:false or error response
- Unsupported country code — non-EU country codes not covered
- Rate limiting or payment failure — x402 payment not processed, request blocked
- Transient VIES outage — partial data returned with status indicating degraded response

## How this service works

Discover agent-ready APIs with REST, MCP, x402, transparent pricing, documented sources and real response examples.

## Output

Returns a JSON object with the VAT number, country code, validity boolean, registered company name and address (when available), the data source (VIES), the check timestamp, and a status field indicating whether VIES was reachable or the data was unavailable at time of request.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": null,
  "valid": null,
  "number": "39356000000",
  "source": "ec.europa.eu:vies",
  "status": "unavailable",
  "address": null,
  "checked_at": "2026-09-07T16:50:12+02:00",
  "vat_number": "FR39356000000",
  "country_code": "FR",
  "request_date": null,
  "request_identifier": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-vat-number-validation-1225b929/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.helpmyagent.com](https://www.zero.xyz/host/api.helpmyagent.com/llms.txt)
