Introduction

Using the REST API

Taxamo is built around a RESTful API - even the JavaScript API and merchant dashboards utilize the REST API underneath. This section of the documentation allows you to familiarise yourself with the basics of the Taxamo API: how to invoke API operations, how to authenticate calls, and suggested formating of request and response messages.
This documentation describes the v2 version of the API.

Taxamo API

The API is built around a Transaction object, which represents everything that is stored about a customer purchase and its calculated tax. Tax can also be calculated without creating a transaction by utilizing the /api/v2/tax endpoint.

$ curl \
 'https://services.taxamo.com/api/v2/dictionaries/product_types?public_token=public_***********'
{
  "dictionary": [
    {
      "code": "default"
    },
    {
      "code": "e-service"
    },
    {
      "code": "e-book"
    },
    {
      "code": "e-newspaper"
    }
  ]
}

Connecting to API

The Taxamo RESTful API is available through the HTTP(S)/1.1 protocol and utilizes HTTP verbs and response codes.

For both production and test modes, the RESTful API is available under the https://services.taxamo.com/api/v2 URL - you just need to use a set of tokens according to the mode you want to use.

Example requests in the documentation are written using the cURL command line tool, but cURL is not required.