Use when an agent needs the current official VIES validation status of an EU VAT number be
Use when an agent needs the current official VIES validation status of an EU VAT number before B2B onboarding, invoicing or procurement. Queries the European Commission VIES REST API and returns whether the number is currently valid, plus the registered company name and address when the member state returns them. It does not give tax advice and is not proof a company is legitimate, an invoice is compliant, or a sanctions/KYC/AML check.
10000 (raw units)
price
1
calls / 30d
1
unique payers
2026-08-30
updated
Provider
agent-api-testnet.tim1712.workers.dev · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:84532",
"payTo": "0x5229384BD502D85aa7EcA0A31B515E5E48d3910F",
"asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
"amount": "10000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"countryCode": "NL",
"vatNumber": "123456789B01"
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"address": "EXAMPLESTRAAT 1\n1234 AB AMSTERDAM",
"checkedAt": "2026-08-30T10:00:02.000Z",
"countryCode": "NL",
"name": "EXAMPLE HOLDING B.V.",
"requestDate": "2026-08-30T00:00:00.000Z",
"source": "eu-vies",
"valid": true,
"vatNumber": "123456789B01",
"warnings": []
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"countryCode": {
"enum": [
"AT",
"BE",
"BG",
"CY",
"CZ",
"DE",
"DK",
"EE",
"EL",
"ES",
"FI",
"FR",
"HR",
"HU",
"IE",
"IT",
"LT",
"LU",
"LV",
"MT",
"NL",
"PL",
"PT",
"RO",
"SE",
"SI",
"SK",
"XI"
],
"type": "string"
},
"vatNumber": {
"maxLength": 24,
"minLength": 1,
"type": "string"
}
},
"required": [
"countryCode",
"vatNumber"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checkedAt": {
"type": "string"
},
"countryCode": {
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requestDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source": {
"const": "eu-vies",
"type": "string"
},
"valid": {
"type": "boolean"
},
"vatNumber": {
"type": "string"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"countryCode",
"vatNumber",
"valid",
"name",
"address",
"requestDate",
"source",
"warnings",
"checkedAt"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://agent-api-testnet.tim1712.workers.dev/v1/business/eu-vat-check" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://agent-api-testnet.tim1712.workers.dev/v1/business/eu-vat-check");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://agent-api-testnet.tim1712.workers.dev/v1/business/eu-vat-check")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/8364.json, and this resource appears in /discovery/resources and /discovery/search.