API Taxrates.io API

Conheça a plataforma

O que integrar com Taxrates.io API

Descrição técnica preservada da especificação de origem. A versão do contrato ajuda a identificar a API; confirme a disponibilidade atual no fornecedor.

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 [email protected] 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 [email protected] 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: [email protected]

Do planejamento à produção

Checklist para integrar Taxrates.io API

1. Defina o fluxo. Identifique quais dados precisam circular, o sistema de origem e o resultado esperado.
2. Leia os requisitos oficiais. Verifique acesso à API, plano necessário, versão e ambiente de testes.
3. Configure o acesso com segurança. Guarde credenciais secretas no servidor e conceda apenas as permissões necessárias. Restrinja chaves públicas conforme a documentação do fornecedor.
4. Teste a primeira requisição. Valide os campos, a paginação e o formato de resposta com dados de teste.
5. Prepare o tratamento de falhas. Considere limites de requisição, retentativas com espera e prevenção de operações duplicadas.
6. Acompanhe a integração. Registre erros sem expor dados sensíveis e monitore alterações na API.