---
title: "Returns list of taxes in a country"
method: GET
path: "/taxes"
tags: ["Taxes"]
---

# Returns list of taxes in a country

`GET /taxes`

This API returns the list of taxes applicable to a product in a country.

## Query parameters

- `country` string, required

## Response `200`

returns list of taxes.

- TaxObject
  - `id` string, uuid — unique uuid of the tax object
  - `country` string — ISO Code of the Country where the taxes are applied
  - `taxCode1` number, double — lowest tax rate in percentage. could be O, a.k.a tax is not applicable
  - `taxCode2` number, double — second tax rate in percentage
  - `taxCode3` number, double — third tax rate in percentage
  - `taxCode4` number, double — fourth tax rate in percentage
  - `taxCode5` number, double — fifth tax rate in percentage
  - `updatedAt` string — The date time that record was updated in our system.
  - `createdAt` string — The date time that record was created in our system.

## Other responses

- `400` — Bad Request
- `401` — The caller is not authenticated
- `403` — Access rights not sufficient
- `500` — Internal Server Error.

---

[API](https://skmtc.dev/bictorys/apis/pay.md) · [All operations](https://skmtc.dev/bictorys/apis/pay/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bictorys/pay/revisions/b85cce14340b/schema)
