List Product Taxes
GET {{baseUrl}}/products/taxes
This API returns all the tax configurations of the products linked to a distributor.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
distributor_id | string | [FILTER] on distributor_id. | |
product_id | string | [FILTER] on product_id. | |
tax_region | string | [FILTER] on tax_region. | |
items_per_page | number | [PAGING] Items Per Page - Allows user's to configure the items_per_page value. For example, to load 100 items per page, the developer may point the user to a url with the query string ?items_per_page=100. This parameter is mainly usefull to manage response times, higher values result in longer response times and therefore it is recommended to keep this value as low as possible. We do allow to adjust this value so it can be used to batch/cache/update inventory at once. |
Clients should anticipate that the value of this parameter may not be honored by the API, and should rely exclusively on the contents of the items_per_page response element in calculating actual page size. |
| start_index | number | | [PAGING] Index-based paging - Allows user's to jump directly to a specific item position within a list of items. For example, to load 10 items starting at item 200, the developer may point the user to a url with the query string ?start_index=200. |
| page | number | | [PAGING] Page-based paging - Allows user's to jump directly to a specific page within the items. This is similar to index-based paging, but saves the developer the extra step of having to calculate the item index for a new page of items. For example, rather than jump to item number 200, the developer could jump to page 20. The urls during page-based paging could use the query string ?page=1 or ?page=20. The page_index and total_pages properties are used for this style of paging. |
RESPONSES
status: OK
{"api_version":"3.4.0","data":{"current_item_count":10,"items_per_page":10,"kind":"voucher","page_index":1,"start_index":1,"total_items":200,"total_pages":20,"items":[{"tax_id":"TAX_ID_123","tax_name":"VAT Regular 20%","tax_rate":"20.00","tax_type":"VAT","tax_region":"Netherlands"},{"tax_id":"TAX_ID_123","tax_name":"VAT Regular 20%","tax_rate":"20.00","tax_type":"VAT","tax_region":"Netherlands"}]}}