DOCS

Request a classification

/

Request a classification

Classify API 

Create a new request for an item classification to the universal (6-digit) or country-specific (8+ digit) HS code.

Learn more about Classify.

Note

To obtain a classification, you must provide a description. It is up to you which field(s) you provide, but we recommend you provide as much information as possible to receive a more accurate classification.

POST | https://api.zonos.com/v1/classify

JSON KEY/VALUE PAIRS in the request body

item REQUIREDThe item that is getting exported to be classified.
item.age OPTIONALThe age of the item. E.g., “1784-1820” or “3rd Century A.D.”
item.amount OPTIONALThe price of the item.
item.brand OPTIONALThe brand of the item.
item.category OPTIONALThe item category.
item.description REQUIREDThe description of goods for the commercial invoice. This description will usually differ from the retail description and typically includes a general description of what it is, what it is made from, and what it is used for.
item.detail OPTIONALAdditional features, attributes, or descriptions of the item.
item.gender OPTIONALThe gender reference associated to the item.
item.hs_code OPTIONALAs many known digits of the HS code, which will be used for sub-classifications, e.g., if you are classifying a list of knitted clothing, input “61” to force the logic to find codes within chapter 61.
item.image_url OPTIONALThe image URL.
item.language_code OPTIONALThe ISO 639-1 language code. If null, English is the default language.
item.material OPTIONALThe material composition of the item.
item.product_id OPTIONALThe retailer or exporter’s unique item identifier for the product.
item.sku OPTIONALThe item's SKU.
item.sub_category OPTIONALThe category most closely associated with the item.
ship_to_country OPTIONALThe destination country, represented by a two-letter ISO code. This field is required for a country-specific HTS 8+ digit classification.

Classify request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "item": {
    "id": "29342",
    "amount": 12.99,
    "brand": null,
    "category": "women's clothing",
    "description": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
    "detail": null,
    "gender": "women",
    "hs_code": "6116",
    "image_url": "https://zonos.com/images/cozygloves.png",
    "item_age": null,
    "language_code": "en",
    "material": "cotton",
    "product_id": "895669256385",
    "subcategory": "women's accessories"
  },
  "ship_to_country": null
}

Example response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "id": "clfy_6PU4EDbKE1DlDMYxbDwyfK",
  "product_id": "895669256385",
  "classified_code": "6116.99",
  "codes": [
    {
      "code": "6116.99",
      "description": "Other: Of other textile materials",
      "type": "subHeading"
    },
    {
      "code": "6116",
      "description": "Gloves, mittens, and mitts, knitted or crocheted",
      "type": "heading"
    },
    {
      "code": "61",
      "description": "Apparel and clothing, knitted or crocheted",
      "type": "chapter"
    }
  ],
  "providedHsCodeStatus": "VALID",
  "combinedDescription": "Gloves, mittens and mitts, knitted or crocheted: of other textile materials",
  "truncatedCombinedDescription": "Gloves, mittens and mitts, knitted or crocheted"
}

Was this page helpful?


© 2023 Zonoszonos.com