vatnode API Documentation
Welcome to the vatnode API documentation. vatnode provides a simple, reliable REST API for validating EU VAT numbers and retrieving VAT rates.
Features
- Real-time VAT Validation - Verify VAT numbers directly against the EU VIES database
- VAT Rates API - Get current VAT rates for all 27 EU member states. Need rates without an API key? Try the free open-source eu-vat-rates-data package.
- Smart Caching - Responses are cached for optimal performance
- Change Monitoring - Subscribe to VAT IDs and receive webhooks on changes (paid plans)
Base URL
All API requests should be made to:
Production
https://api.vatnode.dev/v1Authentication
Most endpoints require authentication via API key. Include your key in the Authorization header:
Terminal
curl https://api.vatnode.dev/v1/vat/IE6388047V \
-H "Authorization: Bearer vat_live_your_api_key"See the Authentication section for details on obtaining and managing API keys.
Quick Example
Terminal
# Validate a VAT number
curl https://api.vatnode.dev/v1/vat/IE6388047V \
-H "Authorization: Bearer vat_live_..."Response
{
"valid": true,
"vatId": "IE6388047V",
"countryCode": "IE",
"countryName": "Ireland",
"companyName": "GOOGLE IRELAND LIMITED",
"companyAddress": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
"checkedAt": "2026-03-26T14:25:57.209Z",
"source": "VIES",
"checkId": "019d2a89-a5d9-7b97-b710-57b84604de2b",
"countryVat": {
"vatName": "Value Added Tax",
"vatAbbr": "VAT",
"currency": "EUR",
"standardRate": 23,
"reducedRates": [13.5, 9],
"superReducedRate": null,
"parkingRate": null,
"ratesUpdatedAt": "2026-03-27"
},
"cache": {
"hit": false,
"ttlSeconds": 900
}
}