> For the complete documentation index, see [llms.txt](https://transiteo.gitbook.io/transiteo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://transiteo.gitbook.io/transiteo/free-api/duty-and-taxes-calculation.md).

# Duty & Taxes Free Calculation

Thanks to this free API, you could calculate the duty & taxes from your main product / default HSCode to every countries.

{% hint style="info" %}
**Requirement :** To use this API for free, you have to create an account on the transiteo web app, subscribe to a plan and configure your data settings. The consumption is free.
{% endhint %}

## Duty & Taxes calculation

<mark style="color:blue;">`GET`</mark> `https://api.transiteo.io/v1/taxsrv/freedutyCalculation`

This endpoint allows you to calculate duty & taxes for your default product in all countries.

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-type | string | application/json |
|              | string | "your id\_token" |

{% tabs %}
{% tab title="200 " %}

```
{
    "DutyAmount": number,
    "VatAmount": number,
    "SpecialTaxesAmount": number,
    "global": {
        "amount": number
},
"timestamp": number
}
```

{% endtab %}
{% endtabs %}

### Request body

```
{
  "products": [
      {
        "quantity": number,
        "weight": number,
        "weight_unit": "string",
        "unit_price": number,
        "currency_unit_price": "string",
      }
  ],
  "to_country": "string",
}
```

### Request fields

#### "products" / "quantity"

You need to fill the "quantity" field  with a entire number representing your product units.\
***Examples :** 1 **or** 9*\
***Type :** number*\
***Required :** yes*

#### "products" / "weight"

You need to fill the "weight" field of the product with a number.\
***Examples :** 12 **or** 3.5*\
***Type :** number*\
***Required :** yes if  "unit\_ship\_price" and* "currency\_unit\_ship\_price"*are not mentionned. Or if you request Switzerland in "from\_country".*

#### "products" / "weight\_unit"

You can fill the "weight\_unit" field with one of this two labels : \
**- "kg"** :  if you use the international metric system\
**- "lbs"** : if you use the imperial system\
***Type :** string*\
***Required :** yes if  "unit\_ship\_price" and* "currency\_unit\_ship\_price"*are not mentionned. Or if you request Switzerland in "from\_country".*

#### products" / "unit\_price"

You need to fill the "unit\_price" field with a number representing the price of one product.\
***Examples :** 39 **or** 99.90*\
***Type :** string*\
***Required :** yes*\
\
***"*****products" / "currency\_unit\_price*****"***

You need to fill the "currency" field of the product with a currency iso Alpha 3.\
Download the [list of currencies](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csv) with them name and code.\
***Examples :** "EUR"*\
***Type :** string*\
***Required :** yes*

#### "to\_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\
Download the [list of countries](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\
***Type :** string*\
***Required :** yes*

####

### Response json Format

```
{
    "duty_amount": number,
    "vat_amount": number,
    "special_taxes_amount": number,
    "global": {
        "amount": number
    },
    "timestamp": number
}
```

####

### Response fields

#### "duty\_amount"

The value is the amount price of customs duties\
***Examples :** 10 **or** 3.5*\
***File type :** number*

#### "*vat*\_amount"

The value is the amount price of locales taxes (VAT, GST, ...)\
***Examples :** 10 **or** 3.5*\
***File type :** number*

#### "*special\_taxes*\_amount"

The value is the amount price of specials taxes (OM, OMR, ...)\
***Examples :** 10 **or** 3.5*\
***File type :** number*

#### "*global"* / "*amount"*

The value is the amount prices of customs duties + locales taxes + specials taxes\
***Examples :** 10 **or** 3.5*\
***File type :** number*

####

### JSON Examples - Request & Response

It exist many possibilities. Please [book a call ](https://meetings.hubspot.com/gauthier11/gauthier)with our support team.

### Video explainer

in progress...