# VIES EU VAT Number Validator

> VIES EU VAT Number Validator is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-09).

Validates an EU VAT number against the European Commission's VIES system and returns registration status, business name, and address where available.

## Facts

- Endpoint: POST https://api.vextorium.com/validar-iva-vies-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vies-eu-vat-number-validator-2bdab0d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-2Te8QV339CWeaqrwv6pT

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 vies-eu-vat-number-validator-2bdab0d8 -d '<json body>'
```

Example prompt: Can you check if the French VAT number FR40303265045 is valid and registered for intra-community trade in the EU VIES system?

## When to prefer this

Use this endpoint when you need to verify EU VAT numbers for B2B invoicing compliance, specifically to confirm intra-community trade registration before issuing zero-VAT invoices. It is the authoritative source as it queries the European Commission's official VIES database directly. Prefer this over local tax authority lookups when you need cross-EU coverage in a single API call.

## Known failure modes

- Invalid or malformed VAT number format returns valido: false
- Country does not publish name/address — nombre and direccion fields return null
- VIES system temporarily unavailable (EU Commission downtime)
- VAT number exists but is not registered for intra-community trade
- Missing required 'numero' field returns validation error
- Country prefix not recognized or unsupported

## How this service works

Check in the European Commission's VIES whether an EU VAT number is registered for intra-community trade, with name and address where the country publishes them. Needed to invoice other EU businesses without VAT.

## Output

A JSON object containing: whether the VAT number is valid (boolean), the country code, the full VAT ID with prefix, the registered business name and address (where published by the country), the data source (VIES, European Commission), and the timestamp of the lookup. Some countries like Spain and Germany do not publish name or address, which is noted in the response.

## 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": {
     "required": [
      "numero"
     ],
     "properties": {
      "pais": {
       "type": "string",
       "description": "Country prefix if not included"
      },
      "numero": {
       "type": "string",
       "description": "VAT number with country prefix, e.g. ESA28015865"
      }
     }
    },
    "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",
      "null"
     ],
     "properties": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "pais": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "nombre": {
       "type": [
        "string",
        "null"
       ]
      },
      "numero": {
       "type": [
        "string",
        "null"
       ]
      },
      "valido": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "nif_iva": {
       "type": [
        "string",
        "null"
       ]
      },
      "direccion": {
       "type": [
        "string",
        "null"
       ]
      },
      "consultado": {
       "type": [
        "string",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "nota": "Válido = alta en el censo de operadores intracomunitarios. Algunos países (p. ej. España, Alemania) no publican nombre ni dirección.",
  "pais": "FR",
  "fuente": "VIES, Comisión Europea",
  "nombre": "SA SODIMAS",
  "numero": "40303265045",
  "valido": true,
  "nif_iva": "FR40303265045",
  "direccion": "11 RUE AMPERE 26600 PONT DE L ISERE",
  "consultado": "2026-10-02T15:21:02.134Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vies-eu-vat-number-validator-2bdab0d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)