API Access
Authentication
Send the following API key via the Authorization!
API key: Please log in to retrieve api key.
Simple Search for VAT Rates
GET https://vat-rates.com/api/search
| Parameter | Description | Example |
|---|
| ccs | list of comma separated 2 character country codes | ccs=GB,EL,XI |
| date | iso-formatted date for which the VAT rate situation is queried | date=2023-01-17 |
| searchTerm | the term that is matched against CN, CPA codes, categories and comments | searchTerm=chocolate |
Advanced Search for VAT Rates
GET https://vat-rates.com/api/searchAdvanced
| Parameter | Description | Example |
|---|
| ccs | list of comma separated 2 character country codes | ccs=GB,EL,XI |
| date | iso-formatted date for which the VAT rate situation is queried | date=2023-01-17 |
| categories | list of comma separated ids of categoires as specified by article 98 and 103 of the Council Directive 2006/112/EC of 28 Novemebr 2006, full table can be found here | categories=250|288 |
| cnCodes | list of comma separated CN Codes | cnCodes=4901|4904 00 00|49 |
| cpaCodes | list of comma separated CPA Codes | cpaCodes=58.11.1|58.11|58 |
| fuzzyCorrespondence | boolean value whether to resolve correspondence between CPA and CN codes fuzzier than the data source | fuzzyCorrespondence=true |
Search for CN or CPA Codes
GET https://vat-rates.com/api/codes/[cn|cpa|categories|noneu|all]
| Parameter | Description | Example |
|---|
| search | search string | search=choco |
| language | either en or de | language=de |