# Link (HSCode > HSCode)

## HSCode to get the HSCode 

<mark style="color:green;">`POST`</mark> `https://api.transiteo.io/v1/taxsrv/hscodefinder`

You can transform any HTS Code of any country to another one.

#### Headers

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

{% tabs %}
{% tab title="200 Cake successfully retrieved." %}

```
{    "name":{
    "result": {
        "hs_code": number,
        "hs_version": string,
        "designation": string,
        "product_statut": string
    }
}
```

{% endtab %}
{% endtabs %}

```
{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "from_country" string,
  "to_country": string
}
```

### Request fields

#### "products" / "identification" / "type"

You need to fill with "HSCODE"\
\&#xNAN;***Type :** string*\
\&#xNAN;***Required :** yes*

#### "products" / "identification" / "value"

You need to fill this field with a HSCode  8 to 13 digits.\
\&#xNAN;***Examples :**  9503006100*\
\&#xNAN;***Type :** string*\
\&#xNAN;***Required :** yes*

#### "*from*\_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;***Examples :** "USA"*\
\&#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;***Examples :** "USA"*\
\&#xNAN;***Type :** string*\
\&#xNAN;***Required :** yes*

### JSON Response Format

```
{
    "result": {
        "hs_code": string,
        "hs_version": string,
        "product_statut": string,
        "designation": string,
        "splitted_designation": {
            "chapter_designation": string,
            "heading_designation": string,
            "subheading_designation": string,
            "national_designation": string
        }
    },
    "timestamp": number
}
```

### Response fields & values

#### "hs\_code"

We provide a HSCode of length between 8 and 13. It depends on the "to\_country"  field and product attributes.\
\&#xNAN;***Example :**  "9503006100"*\
\&#xNAN;***Type :** string* &#x20;

#### "hs\_version"

Each country uses a specific HSCode version.\
\&#xNAN;***Examples :** "HS17" **or** "HS12"*\
\&#xNAN;***Type :** string*

#### "designation"

We provide the HSCode designation.\
\&#xNAN;***Example :**  "*&#x45;lectrical machinery and equipment and parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such articles -- heading\_designation : Vacuum cleaners. -- subheading\_designation : Vacuum cleaners, incl. dry cleaners and wet vacuum cleaners, with self-contained electric motor ( excl. of a power <= 1?500?w and having a dust bag or other receptacle capacity <= 20?l) -- national\_designation : Aspirateurs: a moteur électrique incorporé: autres: aspirateurs de poussièers, y compris les aspirateurs de matières sèches et de matières liquide&#x73;*"*\
\&#xNAN;***Type :** string* &#x20;

#### "product\_statut"

We provide the product statut in the destination country. There are 3 cases. \
\&#xNAN;***Example :**  "'Authorized' à l'importation dans ce pays" **or** "'Restricted' à l'importation dans ce pays" **or** "'Prohibited' à l'importation dans ce pays"*\
\&#xNAN;***Type :** string*&#x20;

#### "splitted\_designation" */ "*&#x63;hapter\_designation"

We provide the HSCode chapter designation. \
\&#xNAN;***Example :**  "*&#x45;lectrical machinery and equipment and parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such articles", "heading\_designation": "Vacuum cleaners.*"*\
\&#xNAN;***Type :** string* &#x20;

#### "splitted\_designation" / "heading\_designation"

We provide the HSCode heading designation. \
\&#xNAN;***Example :**  "*&#x56;acuum cleaners.*"*\
\&#xNAN;***Type :** string* &#x20;

#### "splitted\_designation" / "subheading\_designation"

We provide the HSCode subheading designation. \
\&#xNAN;***Example :**  "*&#x56;acuum cleaners, incl. dry cleaners and wet vacuum cleaners, with self-contained electric motor ( excl. of a power <= 1?500?w and having a dust bag or other receptacle capacity <= 20?l)*"*\
\&#xNAN;***Type :** string* &#x20;

#### "splitted\_designation" / "national\_designation"

We provide the HSCode nation designation. \
\&#xNAN;***Example :**  "*&#x41;spirateurs: a moteur électrique incorporé: autres: aspirateurs de poussièers, y compris les aspirateurs de matières sèches et de matières liquide&#x73;*"*\
\&#xNAN;***Type :** string* &#x20;

#### "timestamp"

We provide the result timestamp. \
\&#xNAN;***Example :**  "*&#x31;63844146096&#x31;*"*\
\&#xNAN;***Type :** string*&#x20;


---

# 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/duties-and-taxes-services/hscode-services/using-hscode-recognition.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.