Validate VAT

Normalize and validate business VAT numbers (format + optional VIES check).

Method

POST /v1/verify/vat

Body Parameters

Headers

Authorization · string

Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)

content-type · string

application/json

Request Example

cURL

curl -X POST https://api.voyantcloud.com/v1/verify/vat \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "vat": "RO12345678" }'

Response

200 OK

{
  "ok": true,
  "vat": "GB999999973",
  "isFormatValid": true,
  "viesChecked": false,
  "isRegistered": null
}

The handler applies an EU-format heuristic. Set ENABLE_VIES_CHECK=1 and extend the logic to call VIES, returning isRegistered when authoritative validation is required.