Tax classes | API reference

Basic information

GET /{shopId}/tax-classes

Returns all tax classes of a shop.

Authorisation

OAuth 2.0 Token required with scopes:

products_read

URI parameters

Name	Type	Description
`shopId`	string	The unique identifier of the shop. Required: `true` Example: `DemoShop`

Query parameters

Name	Type	Description
`locale`	string	Represents the language code according to ISO 639-1 and the country code according to ISO 3166-1. If not provided, the shop’s default language is used. We recommend to always send this parameter with your request. If the default language had been changed in the administration, it might take up to 1 day until this change affects the shop. Required: `false` Example: `en_US`
`page`	integer	Represents the current page. Required: `false` Default: `1` Minimum: `1`
`resultsPerPage`	integer	Specifies the maximum number of results per page. Required: `false` Default: `10` Maximum: `100`

Response attributes

Name	Type	Description
`results`	integer	The number of tax classes in total.
`page`	integer	The page number on which the tax classes appears.
`resultsPerPage`	integer	The number of tax classes returned per page.
`items`	array of taxClass	The list of all tax classes.
`defaultTaxClass`	object of taxClass	The default tax class.
`defaultTaxClassDigital`	object of taxClass	The default tax class for digital products and services.

Response

HTTP 200

Media type application/json

{
  "results": 5,
  "page": 1,
  "resultsPerPage": 10,
  "items": [
    {
      "taxClassId": "5446685F-D1DC-0823-D290-D5809AB30FB6",
      "name": "no VAT",
      "links": [
        {
          "rel": "self",
          "href": "https://pm.epages.com/rs/shops/apidocu/tax-classes/5446685F-D1DC-0823-D290-D5809AB30FB6"
        }
      ]
    },
    {
      "taxClassId": "5446685F-A8AF-0E18-9B4F-D5809AB30FBF",
      "name": "standard",
      "links": [
        {
          "rel": "self",
          "href": "https://pm.epages.com/rs/shops/apidocu/tax-classes/5446685F-A8AF-0E18-9B4F-D5809AB30FBF"
        }
      ]
    },
    {
      "taxClassId": "5446685F-8E47-FAB9-87FB-D5809AB30F6D",
      "name": "reduced",
      "links": [
        {
          "rel": "self",
          "href": "https://pm.epages.com/rs/shops/apidocu/tax-classes/5446685F-8E47-FAB9-87FB-D5809AB30F6D"
        }
      ]
    },
    {
      "taxClassId": "54B50D97-A277-9AF2-58A1-D5809AB32230",
      "name": "Digital products and services",
      "links": [
        {
          "rel": "self",
          "href": "https://pm.epages.com/rs/shops/apidocu/tax-classes/54B50D97-A277-9AF2-58A1-D5809AB32230"
        }
      ]
    },
    {
      "taxClassId": "54B50D97-3ADA-E805-55B6-D5809AB3223A",
      "name": "eBooks",
      "links": [
        {
          "rel": "self",
          "href": "https://pm.epages.com/rs/shops/apidocu/tax-classes/54B50D97-3ADA-E805-55B6-D5809AB3223A"
        }
      ]
    }
  ],
  "defaultTaxClass": {
    "taxClassId": "5446685F-A8AF-0E18-9B4F-D5809AB30FBF",
    "name": "standard",
    "links": [
      {
        "rel": "self",
        "href": "https://pm.epages.com/rs/shops/apidocu/tax-classes/5446685F-A8AF-0E18-9B4F-D5809AB30FBF"
      }
    ]
  },
  "defaultTaxClassDigital": {
    "taxClassId": "54B50D97-A277-9AF2-58A1-D5809AB32230",
    "name": "Digital products and services",
    "links": [
      {
        "rel": "self",
        "href": "https://pm.epages.com/rs/shops/apidocu/tax-classes/54B50D97-A277-9AF2-58A1-D5809AB32230"
      }
    ]
  }
}