Keep the rates of your application up-to-date with a regular VAT rate lookup. This ensures that your invoice states the correct VAT across EU Member States. We have also started to add countries outside the EU and will keep them updated.
VAT rates can change irregularly as governments adapt to new circumstances. We track such announcements closely and store scheduled changes in our database. Any such change will take effect at exactly midnight local time of the respective country.
Base of the rate endpoint is the Rate
entity, which is returned from all rates endpoint. You can find the description of the Rate
entity below:
Key | Type | Example | Description |
|
| 20 | Standard rate used in the country. |
|
|
| 3-letter ISO 4217 local currency code. |
|
| N/A | Contains information about the country |
|
|
| 2-letter ISO country code. |
|
|
| Corresponding English name of country_code. |
|
|
| Corresponding name of country_code on local language (in case of multiple national languages, English will be returned) |
|
|
| Identifies if the country is a member state or not |
|
| N/A | Contains rates for different categories relevant for digital products. |
|
|
| Rate for audiobooks. Defaults to |
|
|
| Rate for broadcasting services. Defaults to |
|
|
| Rate for electronic books. Defaults to |
|
|
| Rate for electronic periodical. Defaults to |
|
|
| Rate for electronic services. Defaults to |
|
|
| Rate for telecommunication |
{"success": true,"pagination": {"has_more": false,"total_count": 28},"rates": [{"standart_rate": 20,"currency": "EUR","country": {"code": "AT","name": "Austria","local_name": "Austria","member_state": true},"categories": {"audiobook": 5,"broadcasting": 5,"ebook": 5,"eperiodical": 5,"eservice": 20,"telecommunication": 20}}// ...]}
{"status": 400,"success": false,"error": {"code": 101,"type": "missing_api_key","message": "No API Key provided"}}
Key | Type | Value |
|
| Information about the pagination |
|
| Identifies if we have more data after this request (e.g. if you need to fetch additional page) |
|
| Total items count for your request |
|
| Array of Rate Entities.​ |
{"success": true,"standart_rate": 20,"currency": "EUR","country": {"code": "AT","name": "Austria","local_name": "Austria","member_state": true},"categories": {"audiobook": 5,"broadcasting": 5,"ebook": 5,"eperiodical": 5,"eservice": 20,"telecommunication": 20}}
{"success": false,"status": 400,"error": {"code": 101,"type": "missing_api_key","message": "No API Key provided"}}
{"success": false,"status": 404,"error": {"code": 108,"type": "invalid_country_code","message": "You provided invalid count"}}
{"success": true,"standart_rate": 20,"currency": "EUR","country": {"code": "CH","name": "Switzerland","local_name": "Switzerland","member_state": false},"categories": {"audiobook": 3,"broadcasting": 8,"ebook": 3,"eperiodical": 3,"eservice": 8,"telecommunication": 8}}
{"success": false,"statusCode": 400,"error": {"code": 107,"type": "could_not_resolve_ip","message": "We failed locating the supplied IP Address"}}
{"success": false,"statusCode": 404,"error": {"code": 109,"type": "country_not_found","message": "We were unable to find requested country"}}​