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

# 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"\
***Type :** string*\
***Required :** yes*

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

You need to fill this field with a HSCode  8 to 13 digits.\
***Examples :**  9503006100*\
***Type :** string*\
***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).\
***Examples :** "USA"*\
***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).\
***Examples :** "USA"*\
***Type :** string*\
***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.\
***Example :**  "9503006100"*\
***Type :** string* &#x20;

#### "hs\_version"

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

#### "designation"

We provide the HSCode designation.\
***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;*"*\
***Type :** string* &#x20;

#### "product\_statut"

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

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

We provide the HSCode chapter designation. \
***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.*"*\
***Type :** string* &#x20;

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

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

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

We provide the HSCode subheading designation. \
***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)*"*\
***Type :** string* &#x20;

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

We provide the HSCode nation designation. \
***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;*"*\
***Type :** string* &#x20;

#### "timestamp"

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