EU VAT Validation

Validates an EU VAT number through the European Commission VIES service, with explicit unavailable status.

0.005 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

Validate an EU VAT number before invoicing or supplier onboarding.

Avoid when

Use a more specific endpoint when you only need one already available primitive datum.

Limitations

Results depend on the availability and scope of the cited public sources.

Sources and provenance

European Commission VIES

ec.europa.eu

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema

vat_numberstring

country_codestring

numberstring

View full JSON Schema

{
    "type": "object",
    "properties": {
        "vat_number": {
            "type": "string",
            "pattern": "^(?:AT|BE|BG|CY|CZ|DE|DK|EE|EL|ES|FI|FR|GR|HR|HU|IE|IT|LT|LU|LV|MT|NL|PL|PT|RO|SE|SI|SK|XI)[A-Za-z0-9]{2,14}$"
        },
        "country_code": {
            "type": "string",
            "enum": [
                "AT",
                "BE",
                "BG",
                "CY",
                "CZ",
                "DE",
                "DK",
                "EE",
                "EL",
                "ES",
                "FI",
                "FR",
                "GR",
                "HR",
                "HU",
                "IE",
                "IT",
                "LT",
                "LU",
                "LV",
                "MT",
                "NL",
                "PL",
                "PT",
                "RO",
                "SE",
                "SI",
                "SK",
                "XI"
            ]
        },
        "number": {
            "type": "string",
            "pattern": "^[A-Za-z0-9]{2,14}$"
        }
    },
    "additionalProperties": false,
    "anyOf": [
        {
            "required": [
                "vat_number"
            ]
        },
        {
            "required": [
                "country_code",
                "number"
            ]
        }
    ]
}

Output schema

vat_numberstring

Required

country_codestring

Required

numberstring

Required

statusstring

Required

validboolean | null

Required

request_datestring | null

Required

namestring | null

Required

addressstring | null

Required

request_identifierstring | null

Required

checked_atstring

Required

sourcestring

Required

View full JSON Schema

{
    "type": "object",
    "properties": {
        "vat_number": {
            "type": "string"
        },
        "country_code": {
            "type": "string"
        },
        "number": {
            "type": "string"
        },
        "status": {
            "type": "string"
        },
        "valid": {
            "type": [
                "boolean",
                "null"
            ]
        },
        "request_date": {
            "type": [
                "string",
                "null"
            ]
        },
        "name": {
            "type": [
                "string",
                "null"
            ]
        },
        "address": {
            "type": [
                "string",
                "null"
            ]
        },
        "request_identifier": {
            "type": [
                "string",
                "null"
            ]
        },
        "checked_at": {
            "type": "string"
        },
        "source": {
            "type": "string"
        }
    },
    "additionalProperties": false,
    "required": [
        "vat_number",
        "country_code",
        "number",
        "status",
        "valid",
        "request_date",
        "name",
        "address",
        "request_identifier",
        "checked_at",
        "source"
    ]
}

Example queries

Validate an EU VAT number before invoicing or supplier onboarding.