Use when an agent needs the current official VIES validation status of an EU VAT
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.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://agent-api-production.tim1712.workers.dev/v1/business/eu-vat-check
| Category | Company and compliance |
|---|---|
| Provider host | agent-api-production.tim1712.workers.dev |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.01 | 271 ms |
Example input (from the provider)
{
"body": {
"countryCode": "NL",
"vatNumber": "123456789B01"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$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"
}