Method
POST /v1/verify/vat
Body Parameters
Headers
string
Bearer token (e.g.
Authorization: Bearer YOUR_API_KEY)string
application/jsonRequest Example
curl -X POST https://api.voyantcloud.com/v1/verify/vat \
-H "Authorization: Bearer $VOYANT_API_KEY" \
-H "content-type: application/json" \
-d '{ "vat": "RO12345678" }'
const res = await fetch("https://api.voyantcloud.com/v1/verify/vat", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOYANT_API_KEY}`,
"content-type": "application/json",
},
body: JSON.stringify({ vatNumber: "GB999999973" }),
})
const result = await res.json()
import os, requests
payload = {"vatId": "DE123456789", "countryCode": "DE"}
resp = requests.post(
"https://api.voyantcloud.com/v1/verify/vat",
headers={
"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}",
"content-type": "application/json",
},
json=payload,
)
validation = resp.json()
Response
{
"ok": true,
"vat": "GB999999973",
"isFormatValid": true,
"viesChecked": false,
"isRegistered": null
}
{
"ok": true,
"vat": "INVALID",
"isFormatValid": false,
"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.