The VATlayer API is extremely easy to use. It only takes a few lines of code to make your first validation request. All registered users, whether on a free or paid plan, can use our Quickstart Guide to explore the full range of API functionalities with just one click.
- Existing users: Access the Quickstart Guide below.
- New users: Create an account and get started in minutes.
Step 1: Get Your API Access Key
Sign up for a free or paid plan to start using the VATlayer API. Once registered, your personal API Access Key will be available in the Dashboard. This key is required to authenticate all API requests—keep it secure. You can reset it anytime from your Account Dashboard.
This key authenticates your requests and ensures that you have access to the API features provided by your subscription plan.
2. Basic API Request Structure
All endpoints share a base URL of the form:
https://api.apilayer.net/vatlayer/<endpoint>?access_key=YOUR_ACCESS_KEY&[parameters]3. Example Endpoints
Validate a VAT number
https://api.apilayer.net/vatlayer/validate?access_key=YOUR_ACCESS_KEY&vat_number=LU26375245Example response:
{ "valid": true, "database": "ok", "format_valid": true, "query": "LU26375245", "country_code": "LU", "vat_number": "26375245", "company_name": "AMAZON EUROPE CORE S.A R.L.", "company_address": "38, AVENUE JOHN F. KENNEDY L-1855 LUXEMBOURG" }Get VAT rate for a single country by country code
https://api.apilayer.net/vatlayer/rate?access_key=YOUR_ACCESS_KEY&country_code=DEExample response:
{ "success": true, "country_code": "DE", "country_name": "Germany", "standard_rate": 19, "reduced_rates": { "some foodstuffs": 7, "books (excluding books whose content is harmful to minors)": 7, "medical": 0, "newspapers and periodicals (except those containing content harmful to minors and/or more than 50% advertising)": 7, "intra-community and international passenger transport for certain road, rail and inland waterway transportation": 7, "admission to cultural events": 7, "hotel accommodation (only short-term accommodation)": 7 } }Example shortened: Germany returns 23 reduced-rate categories. The
reduced_rateskeys are free-text category names from the/typesendpoint. They vary by country and are not a fixed list or enum, so read them from the response instead of hard-coding them.Get VAT rates for all EU member states
https://api.apilayer.net/vatlayer/rate_list?access_key=YOUR_ACCESS_KEYCalculate VAT-compliant price
https://api.apilayer.net/vatlayer/price?access_key=YOUR_ACCESS_KEY&amount=125&country_code=GBExample response:
{ "success": true, "country_code": "GB", "country_name": "United Kingdom", "price_excl_vat": 125, "price_incl_vat": 150, "vat_rate": 20 }
4. Optional Parameters / Features
- Use
typeparameter on the price endpoint to calculate with a reduced VAT rate (for specific product types). - Use
incl=1if your amount already includes VAT and you want the API to perform a reverse calculation. - JSONP support: append
callback=CALLBACK_FUNCTIONto the call if you need JSONP. - Use
format=1to pretty-print the JSON response (useful for debugging).