Taxrates.io API

Description

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

AfghanistanGambiaNicaragua
AlbaniaGeorgiaNiger
AndorraGermanyNigeria
AngolaGhanaNorth Korea
Antigua and BarbudaGreeceNorway
ArgentinaGrenadaPakistan
ArmeniaGuamPalestine
ArubaGuatemalaPanama
AustraliaGuineaPapua New Guinea
AustriaGuyanaParaguay
AzerbaijanHaitiPeru
BahamasHondurasPhilippines
BangladeshHungaryPoland
BarbadosIcelandPortugal
BelarusIndiaPuerto Rico
BelgiumIndonesiaRepublic of the Congo
BelizeIranRomania
BeninIrelandRussian Federation
BhutanIsle of ManRwanda
BoliviaIsraelSamoa
BonaireItalySenegal
Bosnia and HerzegovinaJapanSerbia
BotswanaJerseySeychelles
BrazilJordanSierra Leone
BulgariaJordanSingapore
Burkina FasoKazakhstanSlovakia
BurundiKenyaSlovenia
CambodiaKiribatiSolomon Islands
CameroonKosovoSomalia
Cape VerdeKyrgyzstanSouth Africa
Central African RepublicLaosSouth Korea
ChadLatviaSouth Sudan
ChileLebanonSpain
ChinaLesothoSri Lanka
ColumbiaLiberiaSt Lucia
ComorosLiechtensteinSudan
Cook IslandsLithuaniaSuriname
Costa RicaLuxembourgSwaziland
Cote d'IvoireMacedoniaSweden
CroatiaMadagascarSwitzerland
CubaMalawiTahiti
CuracaoMalaysiaTaiwan
CyprusMaldivesTajikistan
Czech RepublicMaliTanzania
Democratic Republic of the CongoMaltaThailand
DenmarkMauritaniaTogo
DjboutiMauritiusTonga
DominicaMexicoTrinidad and Tobago
Dominican RepublicMicronesiaTunisia
EcuadorMoldovaTurkmenistan
EgyptMonacoTuvalu
El SalvadorMongoliaUganda
Equatorial GuineaMontenegroUkraine
EritreaMoroccoUnited Kingdom
EstoniaMozambiqueUnited States
EthiopiaMyanmarUruguay
FijiNamibiaVanuatu
FinlandNepalVenezuela
FranceNetherlandsVietnam
GabonNew ZealandYemen

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 codeProduct Description
C010Services which are not subject to a service-specific tax
C011Software - Downloaded
C012Books - Downloaded
C011Music - Downloaded
C011Movies/Digital Video - Downloaded
C011Other Electronic Goods - Downloaded
C011Streaming Music/Audio Services new
C011Streaming Video Services new
C018Software as a Services, Generally (Remote Access to Hosted Software)
C018Remote Access to Hosted Software - Personal Use
C018Remote Access to Hosted Software - Business Use
C021Remote Access to Hosted Business Custom Applications
C021Personal Cloud Storage/Backup
C021Business Cloud Storage/Backup
C021Business Data Warehouses
C022Infrastructure as Service, Generally
C022Ecommerce Site/Webserver Hosting
C022Provision of Virtual Computing Capacity
C022Software - package or canned program
C022Software - modifications to canned program
C022Software - custom programs - material
C022Software - custom programs - professional serv.
C022Information services
C022Data processing services
C022Mainframe computer access and processing serv.
C022Online 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

  1. CombinedRate
  2. StateRate
  3. CountyRate
  4. CityRate
  5. 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:

CodeError Message
400Bad Request – Your request format is bad.
401Unauthorized – Your API key is wrong.
404Not Found – The specified resource could not be found.
405Method Not Allowed – You tried to access a resource with an invalid method.
429Too Many Requests – You’re requesting too many resources! Slow down!
500Internal Server Error – We had a problem with our server. Try again later.
503Service 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

Use this page to mock Taxrates.io API in your testing and development.

Run our mock API sample using the open source WireMock library, or in the free edition of WireMock Cloud. You'll have a working API server simulating the behavior of Taxrates.io API, which will allow you to keep building and testing even if the actual API you isn't currently available.

Related mocks

Tradematic Cloud API

Overview Tradematic Cloud is a trading

SpectroCoin Merchant

This is an API designed for merchants

Open Data API

Latest Swagger specification for

Xero Files API

These endpoints are specific to Xero

GOV.UK Pay API

GOV.UK Pay API (This version is no

BIN Lookup API

BIN lookup API, the free api service

Ready to accelerate your development flow

Shorter release cycles, more predictable schedules and fewer defects in production.
Start Mocking for Free *Free forever. No credit card needed