Taxrates.io API 1.0.0
Added: 24/10/2017
Updated at: 06/03/2023
Introduction
Taxrates.io is a global tax rate service that automates the management of monitoring tax rates changes in 181 countries. We monitor over 14,000 US sales tax, VAT, GST rates for you and make updates via our API so you always have the most update tax rates.
You can use Taxrates.io as a virtual sandbox where we provide you with 30 days free trial.
Countries
We currently support the following countries around the world. If you would like to request the addition of a new country, please email us at support@taxrates.io
| Afghanistan | Gambia | Nicaragua |
| Albania | Georgia | Niger |
| Andorra | Germany | Nigeria |
| Angola | Ghana | North Korea |
| Antigua and Barbuda | Greece | Norway |
| Argentina | Grenada | Pakistan |
| Armenia | Guam | Palestine |
| Aruba | Guatemala | Panama |
| Australia | Guinea | Papua New Guinea |
| Austria | Guyana | Paraguay |
| Azerbaijan | Haiti | Peru |
| Bahamas | Honduras | Philippines |
| Bangladesh | Hungary | Poland |
| Barbados | Iceland | Portugal |
| Belarus | India | Puerto Rico |
| Belgium | Indonesia | Republic of the Congo |
| Belize | Iran | Romania |
| Benin | Ireland | Russian Federation |
| Bhutan | Isle of Man | Rwanda |
| Bolivia | Israel | Samoa |
| Bonaire | Italy | Senegal |
| Bosnia and Herzegovina | Japan | Serbia |
| Botswana | Jersey | Seychelles |
| Brazil | Jordan | Sierra Leone |
| Bulgaria | Jordan | Singapore |
| Burkina Faso | Kazakhstan | Slovakia |
| Burundi | Kenya | Slovenia |
| Cambodia | Kiribati | Solomon Islands |
| Cameroon | Kosovo | Somalia |
| Cape Verde | Kyrgyzstan | South Africa |
| Central African Republic | Laos | South Korea |
| Chad | Latvia | South Sudan |
| Chile | Lebanon | Spain |
| China | Lesotho | Sri Lanka |
| Columbia | Liberia | St Lucia |
| Comoros | Liechtenstein | Sudan |
| Cook Islands | Lithuania | Suriname |
| Costa Rica | Luxembourg | Swaziland |
| Cote d'Ivoire | Macedonia | Sweden |
| Croatia | Madagascar | Switzerland |
| Cuba | Malawi | Tahiti |
| Curacao | Malaysia | Taiwan |
| Cyprus | Maldives | Tajikistan |
| Czech Republic | Mali | Tanzania |
| Democratic Republic of the Congo | Malta | Thailand |
| Denmark | Mauritania | Togo |
| Djbouti | Mauritius | Tonga |
| Dominica | Mexico | Trinidad and Tobago |
| Dominican Republic | Micronesia | Tunisia |
| Ecuador | Moldova | Turkmenistan |
| Egypt | Monaco | Tuvalu |
| El Salvador | Mongolia | Uganda |
| Equatorial Guinea | Montenegro | Ukraine |
| Eritrea | Morocco | United Kingdom |
| Estonia | Mozambique | United States |
| Ethiopia | Myanmar | Uruguay |
| Fiji | Namibia | Vanuatu |
| Finland | Nepal | Venezuela |
| France | Netherlands | Vietnam |
| Gabon | New Zealand | Yemen |
Products codes
The Taxrates.io API’s provides product-level tax rates for a subset of product codes. These codes are to be used for products that are either exempt from tax in some jurisdictions or are taxed at reduced rates.
We will be expanding support for additional, less common categories over time. If you would like to request the addition of a new product category, please email us at support@taxrates.io
Please select a product code/s when making a request to the Taxrates.io API
| Product code | Product Description |
|---|---|
| C010 | Services which are not subject to a service-specific tax |
| C011 | Software - Downloaded |
| C012 | Books - Downloaded |
| C011 | Music - Downloaded |
| C011 | Movies/Digital Video - Downloaded |
| C011 | Other Electronic Goods - Downloaded |
| C011 | Streaming Music/Audio Services new |
| C011 | Streaming Video Services new |
| C018 | Software as a Services, Generally (Remote Access to Hosted Software) |
| C018 | Remote Access to Hosted Software - Personal Use |
| C018 | Remote Access to Hosted Software - Business Use |
| C021 | Remote Access to Hosted Business Custom Applications |
| C021 | Personal Cloud Storage/Backup |
| C021 | Business Cloud Storage/Backup |
| C021 | Business Data Warehouses |
| C022 | Infrastructure as Service, Generally |
| C022 | Ecommerce Site/Webserver Hosting |
| C022 | Provision of Virtual Computing Capacity |
| C022 | Software - package or canned program |
| C022 | Software - modifications to canned program |
| C022 | Software - custom programs - material |
| C022 | Software - custom programs - professional serv. |
| C022 | Information services |
| C022 | Data processing services |
| C022 | Mainframe computer access and processing serv. |
| C022 | Online Data processing services |
Filtering
When calling the API endpoints you can use 'filter' parameters to get tax rate for the selected type. You can get the following tax types (Each tax rate will always have one of following types)
US Sales tax Rates
- CombinedRate
- StateRate
- CountyRate
- CityRate
- SpecialRate
We recommend using Postman when discovering our API. Happy using!
Rate Limiting
We limit API requests.
If you’re exceeding this rate and encountering 429 errors, review the following:
- Only make requests in states / regions where you have enabled.
- Cache responses if the order details haven’t changed since the last calculation at checkout.
Errors
The Taxrates.io API uses the following error codes:
| Code | Error Message |
|---|---|
| 400 | Bad Request – Your request format is bad. |
| 401 | Unauthorized – Your API key is wrong. |
| 404 | Not Found – The specified resource could not be found. |
| 405 | Method Not Allowed – You tried to access a resource with an invalid method. |
| 429 | Too Many Requests – You’re requesting too many resources! Slow down! |
| 500 | Internal Server Error – We had a problem with our server. Try again later. |
| 503 | Service Unavailable – We’re temporarily offline for maintenance. Try again later. |
Verify your API token is correct and make sure you’re correctly setting the Authorization header.
If you’re still not sure what’s wrong, contact us and we’ll investigate.
Changelog
Stay on top of new developer-facing features, accuracy improvements, and bug fixes for our API. Have a request? Encounter an issue? We’d love to hear your feedback.
Contact Support: Name: apiteam@taxrates.io