# Duty & Taxes Free Calculation

{% 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.\
\&#xNAN;***Examples :** 1 **or** 9*\
\&#xNAN;***Type :** number*\
\&#xNAN;***Required :** yes*

#### "products" / "weight"

You need to fill the "weight" field of the product with a number.\
\&#xNAN;***Examples :** 12 **or** 3.5*\
\&#xNAN;***Type :** number*\
\&#xNAN;***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 : \
\&#xNAN;**- "kg"** :  if you use the international metric system\
\&#xNAN;**- "lbs"** : if you use the imperial system\
\&#xNAN;***Type :** string*\
\&#xNAN;***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.\
\&#xNAN;***Examples :** 39 **or** 99.90*\
\&#xNAN;***Type :** string*\
\&#xNAN;***Required :** yes*\
\
\&#xNAN;***"*****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.\
\&#xNAN;***Examples :** "EUR"*\
\&#xNAN;***Type :** string*\
\&#xNAN;***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).\
\&#xNAN;***Type :** string*\
\&#xNAN;***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\
\&#xNAN;***Examples :** 10 **or** 3.5*\
\&#xNAN;***File type :** number*

#### "*vat*\_amount"

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

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

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

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

The value is the amount prices of customs duties + locales taxes + specials taxes\
\&#xNAN;***Examples :** 10 **or** 3.5*\
\&#xNAN;***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...


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://transiteo.gitbook.io/transiteo/free-api/duty-and-taxes-calculation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.