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.
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 REQUIRED | The item that is getting exported to be classified. |
item.age OPTIONAL | The age of the item. E.g., “1784-1820” or “3rd Century A.D.” |
item.amount OPTIONAL | The price of the item. |
item.brand OPTIONAL | The brand of the item. |
item.category OPTIONAL | The item category. |
item.description REQUIRED | The 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 OPTIONAL | Additional features, attributes, or descriptions of the item. |
item.gender OPTIONAL | The gender reference associated to the item. |
item.hs_code OPTIONAL | As 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 OPTIONAL | The image URL. |
item.language_code OPTIONAL | The ISO 639-1 language code. If null, English is the default language. |
item.material OPTIONAL | The material composition of the item. |
item.product_id OPTIONAL | The retailer or exporter’s unique item identifier for the product. |
item.sku OPTIONAL | The item's SKU. |
item.sub_category OPTIONAL | The category most closely associated with the item. |
ship_to_country OPTIONAL | The 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"
}
Request a classification