Product > HSCode

This endpoint allows you to identify the Harmonized System Code (between 8 & 13 digits) with a product name, description or barcode, ... thanks to our A.I.

There are 2 differents endpoints to find a HSCode from a product tittle, description & barcode, url, image, it depends of your products :

  • Fret & Ecommerce - En / Fr (Text only) > Response in 300ms

  • Fret & Ecommerce - All languages (Text & barcode) > Response between 5 and 20 s

Fret & Ecommerce - En / Fr

Post product title, description or barcode to get the importation HS Code

POST https://api.transiteo.io/v4.1/taxsrv/hscodefinder

Headers

NameTypeDescription

Content-type

string

application/json

Authorization

string

"your id_token"

{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "lang": "fr" ,
  "to_country": string
}

JSON Request Format

{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "to_country": string,
  "ai_score": boolean,
  "multi_results": number
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title, description, sku or barcode. We manage 2 languages (English & French) Examples : TEXT : "Ballon de football" or "Eggs" or "WASHERS FOR SPRINGING" SKU : "JHYU8_^ù/76YH" Type : string Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT" or "SKU" to use the transiteo I.A 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. Examples : "CHE" Type : string Required : yes

"ai_score"

Get the scoring of the AI in the result. Examples : "true" Type : boolean Required : yes

"multi_results"

Get multi HSCode results. Examples : 3 Type : number Required : yes

JSON Response Format

[{
    "result": {
        "hs_code": string,
        "hs_version": string,
        "designation": string,
        "splitted_designation": {
            "chapter_designation": string,
            "heading_designation": string,
            "subheading_designation": string,
            "national_designation": string
        }
        "ai_score": number
    },
    "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

"hs_version"

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

"designation"

We provide the HSCode designation. Example : "Toys, games and sports requisites; parts and accessories thereof -- heading_designation : Articles and equipment for general physical exercise, gymnastics, athletics, other sports (including table-tennis) or outdoor games, not specified or included elsewhere in this chapter; swimming pools and paddling pools. -- subheading_designation : Inflatable balls -- national_designation : Inflatable balls" Type : string

"product_statut"

We provide the product statut in the destination country. There are 3 cases. Example : "'Autorised" or "'Restricted" or "'Prohibited" Type : string

"splitted_designation" / "chapter_designation"

We provide the HSCode chapter designation. Example : "Toys, games and sports requisites; parts and accessories thereof" Type : string

"splitted_designation" / "heading_designation"

We provide the HSCode heading designation. Example : "Articles and equipment for general physical exercise, gymnastics, athletics, other sports (including table-tennis) or outdoor games, not specified or included elsewhere in this chapter; swimming pools and paddling pools." Type : string

"splitted_designation" / "subheading_designation"

We provide the HSCode subheading designation. Example : "Inflatable balls" Type : string

"splitted_designation" / "national_designation"

We provide the HSCode nation designation. Example : "Inflatable balls" Type : string

"timestamp"

We provide the result timestamp. Example : "1638440602271" Type : string

Fret & Ecommerce - All languages

Post product title, description or barcode to get the importation HS Code

POST https://api.transiteo.io/v1/taxsrv/hscodefinder

Headers

NameTypeDescription

Content-type

string

application/json

Authorization

string

"your id_token"

{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "lang": "fr" ,
  "to_country": string
}

JSON Request Format

{
  "product": {
    "identification": [{
      "value": string,
      "type": string
    }]
  },
  "to_country": string,
  "ai_score": boolean,
  "multi_results": number
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title, description, sku or barcode. We manage 3 languages (English, French & Spanish) Examples : TEXT : "Ballon de football" or "Snacks Feringa, laits Catessy et My Star pour répondre aux besoins des chats et chatons... ils vont se régaler ! Faites découvrir les friandises au lait à votre chat grâce à ce lot mixte à prix mini !" or "0711719407577" SKU : "JHYU8_^ù/76YH" Type : string Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT" to use the transiteo I.A 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. Examples : "CHE" Type : string Required : yes

"ai_score"

Get the scoring of the AI in the result. Examples : "true" Type : boolean Required : yes

"multi_results"

Get multi HSCode results. Examples : 3 Type : number Required : yes

JSON Response Format

[{
    "result": {
        "hs_code": string,
        "hs_version": string,
        "designation": string,
        "splitted_designation": {
            "chapter_designation": string,
            "heading_designation": string,
            "subheading_designation": string,
            "national_designation": string
        }
        "ai_score": number
    },
    "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

"hs_version"

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

"designation"

We provide the HSCode designation. Example : "Toys, games and sports requisites; parts and accessories thereof -- heading_designation : Articles and equipment for general physical exercise, gymnastics, athletics, other sports (including table-tennis) or outdoor games, not specified or included elsewhere in this chapter; swimming pools and paddling pools. -- subheading_designation : Inflatable balls -- national_designation : Inflatable balls" Type : string

"product_statut"

We provide the product statut in the destination country. There are 3 cases. Example : "'Autorised" or "'Restricted" or "'Prohibited" Type : string

"splitted_designation" / "chapter_designation"

We provide the HSCode chapter designation. Example : "Toys, games and sports requisites; parts and accessories thereof" Type : string

"splitted_designation" / "heading_designation"

We provide the HSCode heading designation. Example : "Articles and equipment for general physical exercise, gymnastics, athletics, other sports (including table-tennis) or outdoor games, not specified or included elsewhere in this chapter; swimming pools and paddling pools." Type : string

"splitted_designation" / "subheading_designation"

We provide the HSCode subheading designation. Example : "Inflatable balls" Type : string

"splitted_designation" / "national_designation"

We provide the HSCode nation designation. Example : "Inflatable balls" Type : string

"timestamp"

We provide the result timestamp. Example : "1638440602271" Type : string

PreviousHarmonized System CodeNextHS Code > HS Code

Last updated