← Docs

VAT API

Checksum a VAT number. Deep asks the live registry.

Checksum a VAT number before you store it. You get the normalized number and the country. That counts as a normal request. A string that is not a VAT number answers valid: false as a 200, never a 404.

Deep asks the live EU registry for registered, legal name, and address. ?from= your own VAT number to get a consultation identifier for your audit file. Those calls use your plan's monthly VAT lookup allowance. Free includes 100. Each deep request on a checksum-valid EU number uses one lookup. UK GB numbers parse on core. Live HMRC is a follow-up, so GB deep ships registered null and does not use a unit.

Validate

GET
api.parseapi.com/vat/{number}
Format and checksum. Deep adds registered, name, and address
curl "https://api.parseapi.com/vat/DE136695976" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "vat": "DE136695976",
  "valid": true,
  "country": "DE"
}
curl "https://api.parseapi.com/vat/not-a-vat" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "vat": null,
  "valid": false,
  "country": null
}

Response fields

vat
Normalized number with country prefix, or null if invalid
valid
Format and checksum match the country
country
ISO 3166-1 alpha-2. GR not EL. XI numbers ship GB
from
Your requester VAT when ?from= parsed, else omitted

Deep registry

Live VIES check. Counts toward your plan's monthly VAT lookup allowance. See Plans. Member-state downtime is HTTP 503, never registered false.

curl "https://api.parseapi.com/vat/DE136695976?deep=true" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "vat": "DE136695976",
  "valid": true,
  "country": "DE",
  "deep": {
    "registered": false,
    "name": null,
    "address": null,
    "consultation": null,
    "consulted": "2026-08-31T04:13:10.436Z"
  }
}

Deep fields

deep.registered
On the live national registry
deep.name
Registered legal name, or null
deep.address
street, city, postal, country. null when the registry sent none
deep.consultation
Audit identifier when ?from= is a valid VAT, else null
deep.consulted
Registry timestamp of this check

Questions? Email