Question 1

How to request a classification?

Accepted Answer

Create a new request for an item classification to the universal (6-digit) or country-specific (8+ digit) HS code. 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.

Question 2

What are the JSON key/value pairs in the request body for classification?

Accepted Answer

The JSON key/value pairs in the request body include `item`, `item.age`, `item.amount`, `item.brand`, `item.category`, `item.description`, `item.detail`, `item.gender`, `item.hs_code`, `item.image_url`, `item.language_code`, `item.material`, `item.product_id`, `item.sku`, `item.sub_category`, and `ship_to_country`.

Question 3

What is an example of a classify request?

Accepted Answer

An example of a classify request is: {"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","sub_category": "women's accessories"},"ship_to_country": null}

Question 4

What is an example of a classify response?

Accepted Answer

An example of a classify response is: {"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"}

Field	Notes
`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.

Request a classification

Request a classification

Attributes

JSON key/value pairs in the request body

Was this page helpful?