Validate Endpoint

GET /v1/validate/:vat_id

Validates a VAT ID against VIES and/or BZSt.

Authentication: Required (API key)

Path Parameters

Parameter	Type	Description
vat_id	string	The VAT ID to validate (e.g., DE811575812)

Query Parameters

Parameter	Type	Description
requester_vat_id	string	Your own VAT ID (for BZSt qualified requests)
company_name	string	Expected company name (triggers qualified confirmation)
company_city	string	Expected city
company_zip	string	Expected postal code
force_live	boolean	Skip cache, query source directly

Response

{
  "valid": true,
  "vat_id": "DE811575812",
  "country_code": "DE",
  "vat_number": "811575812",
  "company_name": "SAP SE",
  "company_address": "Dietmar-Hopp-Allee 16, 69190 Walldorf",
  "source": "vies",
  "source_timestamp": "2024-01-15T10:30:00Z",
  "cache": false,
  "qualified_confirmation": null,
  "request_id": "abc123",
  "requested_at": "2024-01-15T10:30:00Z"
}

Qualified Confirmation

When company_name, company_city, or company_zip are provided, BZSt returns match results:

{
  "qualified_confirmation": {
    "company_name": "match",
    "company_city": "match",
    "company_zip": "not_queried",
    "company_street": "not_queried"
  }
}

Match values: match, mismatch, not_queried, not_provided