Question 1

How to request a bulk classification using Zonos' Classify API?

Accepted Answer

To request a bulk classification, you need to create a new request for a bulk item classification to the universal (6-digit) or country-specific (8+ digit) HS codes. You must provide a description for each item you want to classify. It's recommended to provide as much information as possible to receive a more accurate classification. The request should be sent to 'https://api.zonos.com/v1/classify/bulk'.

Question 2

What information should be included in the request body for bulk classification?

Accepted Answer

The request body should include a list of items being exported to be classified. For each item, you can provide optional information such as the age, price, brand, category, additional features, gender reference, known digits of the HS code, image URL, ISO 639-1 language code, material composition, unique item identifier, and closely associated category. You must provide a description for each item. You can also specify the destination countries using a two-letter ISO code.

Question 3

What does a bulk classification request example look like?

Accepted Answer

An example of a bulk classification request includes a list of items with their respective details and the destination countries. Each item in the list includes an id, amount, brand, category, description, gender, hs_code, image_url, language_code, material, product_id, and sub_category. The destination countries are represented by a two-letter ISO code.

Question 4

What does a bulk classification response example look like?

Accepted Answer

A bulk classification response includes a list of items with their respective details and the destination countries. Each item in the list includes an id, ship_to_country, hs_code, tariff_description, chapter, chapter_description, heading, heading_description, subheading, subheading_description, combinedDescription, and truncatedCombinedDescription.

Field↕	Notes↕
`items` REQUIRED	List of items being exported to be classified.
`item[index].item.age` OPTIONAL	The age of the item, e.g., 1784-1820 or 3rd Century A.D.
`items[index].item.amount` OPTIONAL	The price of the item.
`items[index].item.brand` OPTIONAL	The brand of the item.
`items[index].item.category` OPTIONAL	The item category.
`items[index].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 is used for.
`items[index].item.detail` OPTIONAL	Additional features, attributes, or descriptions of the item.
`items[index].item.gender` OPTIONAL	The gender reference associated to the item.
`items[index].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.
`items[index].item.image_url` OPTIONAL	The image URL.
`items[index].item.language_code` OPTIONAL	The ISO 639-1 language code. If `null`, English is the default language.
`item[index].material` OPTIONAL	The material composition of the item.
`item[index].product_id` OPTIONAL	The merchant or exporter’s unique item identifier for the product.
`item[index].sub_category` OPTIONAL	The category most closely associated with the item.
`ship_to_countries`OPTIONAL	The destination countries, represented by a two-letter ISO code. This field is required for a country-specific HTS eight-digit+ classification.

Request a bulk classification

Attributes

JSON key/value pairs in the request body

Example request

Was this page helpful?