
Getting started
What is vatnode?
vatnode is an EU VAT number validation API. You send a VAT ID, and vatnode checks it in real time against the official EU VIES system, enriches it with national registry data where available, and returns a clean JSON response with the validity result, company details, VAT rates for that country, and a timestamped audit reference. It’s built for developers adding VAT validation to invoicing, checkout, or supplier-onboarding flows.
What a request looks like
One endpoint does the core job: GET /v1/vat/{vatId}, authenticated with your API key as a Bearer token. The VAT ID includes its two-letter country prefix, for example IE6388047V. The call is curl https://api.vatnode.dev/v1/vat/IE6388047V -H "Authorization: Bearer vat_live_…".
What comes back
valid– whether the number is valid and active.companyNameandcompanyAddress– as VIES returns them; they can benullfor some countries.- Registry data such as registration date, legal form, industry, registry code and tax ID, for the countries where a national registry is connected (see the country coverage reference).
countryVat– the local tax name, abbreviation and rate tiers for the company’s country, so you can label and rate an invoice from the same call.checkIdandverifiedAt– vatnode’s own reference and timestamp for the check.source– which system produced the answer:VIES,CACHE, or a national registry code.
Coverage
All 27 EU member states plus Northern Ireland (XI) are supported. Greece uses the VIES prefix EL.
Where to go next
Create a free account and follow the quickstart guide to make your first call. To understand the data source first, What is VIES? explains how the EU system works.