Attributes
JSON key/value pairs in the request body
POST | https://api.zonos.com/v1/classify/bulk
The header above is a required input for this bulk classification request to complete successfully.
| 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_countriesOPTIONAL | The destination countries, represented by a two-letter ISO code. This field is required for a country-specific HTS eight-digit+ classification. |
Example request
CLASSIFY REQUEST
JSON
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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
{
"items": [
{
"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"
}
},
{
"item": {
"id": "29343",
"amount": 19.99,
"brand": null,
"category": null,
"description": "Cadet Army Cap Basic Everyday Military Style Hat",
"detail": null,
"gender": "men's",
"hs_code": null,
"image_url": "https://zonos.com/images/cadethat.png",
"item_age": null,
"language_code": "en",
"material": null,
"product_id": "895669256378",
"sub_category": null
}
},
{
"item": {
"id": "29344",
"amount": 45.29,
"brand": "Ray Ban",
"category": "Accessories",
"description": "Vintage Aviator Square Sunglasses",
"detail": null,
"gender": null,
"hs_code": null,
"image_url": "https://zonos.com/images/vintagesunglasses.png",
"item_age": null,
"language_code": "en",
"material": null,
"product_id": "895669256399",
"sub_category": "Sunglasses"
}
}
],
"ship_to_countries": ["CA", "FR"]
}
Example response
CLASSIFY OBJECT
JSON
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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
{
"items": [
{
"id": "29342",
"ship_to_country": "CA",
"hs_code": "6116.99.0000",
"tariff_description": "Of other textile materials",
"chapter": "61",
"chapter_description": "Apparel and clothing, knitted or crocheted",
"heading": "6116",
"heading_description": "Gloves, mittens, and mitts, knitted or crocheted",
"subheading": "6116.99",
"subheading_description": "Gloves, mittens, and mitts of other textile materials",
"combinedDescription": "Of other textile materials: of other textile materials",
"truncatedCombinedDescription": "Of other textile materials: of other textile"
},
{
"id": "29342",
"ship_to_country": "FR",
"hs_code": "6116.99.0000",
"tariff_description": "Of other textile materials",
"chapter": "61",
"chapter_description": "Apparel and clothing, knitted or crocheted",
"heading": "6116",
"heading_description": "Gloves, mittens, and mitts, knitted or crocheted",
"subheading": "6116.99",
"subheading_description": "Gloves, mittens, and mitts of other textile materials",
"combinedDescription": "Of other textile materials: of other textile materials",
"truncatedCombinedDescription": "Of other textile materials: of other textile"
},
{
"id": "29343",
"ship_to_country": "CA",
"hs_code": "6505.00.4000",
"tariff_description": "Other hats, hoods, caps, bonnets or berets",
"chapter": "65",
"chapter_description": "Hats and headgear",
"heading": "6505",
"heading_description": "Hats and other headgear of textile materials; visors, hairnets, etc.",
"subheading": "6505.00",
"subheading_description": "knitted hats and visors",
"combinedDescription": "Other hats, hoods, caps, bonnets or berets",
"truncatedCombinedDescription": "Other hats, hoods, caps, bonnets or berets"
},
{
"id": "29343",
"ship_to_country": "FR",
"hs_code": "6505.00.3000",
"tariff_description": "Peaked caps",
"chapter": "65",
"chapter_description": "Hats and headgear",
"heading": "6505",
"heading_description": "Hats and other headgear of textile materials; visors, hairnets, etc.",
"subheading": "6505.00",
"subheading_description": "knitted hats and visors",
"combinedDescription": "Hats and other headgear, knitted or crocheted, or made up from lace, felt or other textile fabric, in the piece (but not in strips), whether or not lined or trimmed; hair-nets of any material, whether or not lined or trimmed: Peaked caps",
"truncatedCombinedDescription": "Hats and other headgear, knitted or crocheted"
},
{
"id": "29344",
"ship_to_country": "CA",
"hs_code": "9004.10.0000",
"tariff_description": "Sunglasses",
"chapter": "90",
"chapter_description": "Optic fiber cables, optical lenses, glasses, binoculars, cameras and projectors, medical appliances, and other measuring instruments",
"heading": "9004",
"heading_description": "Eyewear",
"subheading": "9004.10",
"subheading_description": "Sunglasses",
"combinedDescription": "Spectacles, goggles and the like, corrective, protective or other: sunglasses: Sunglasses",
"truncatedCombinedDescription": "Spectacles, goggles and the like, corrective,"
},
{
"id": "29344",
"ship_to_country": "FR",
"hs_code": "9004.10.9900",
"tariff_description": "Other: other",
"chapter": "90",
"chapter_description": "Optic fiber cables, optical lenses, glasses, binoculars, cameras and projectors, medical appliances, and other measuring instruments",
"heading": "9004",
"heading_description": "Eyewear",
"subheading": "9004.10",
"subheading_description": "Sunglasses",
"combinedDescription": "Spectacles, goggles and the like, corrective, protective or other: sunglasses",
"truncatedCombinedDescription": "Spectacles, goggles and the like, corrective,"
}
]
}
Request a bulk classification
Explore the key/value pairs in a bulk classification request.
Create a new request for a bulk item classification to the universal (6-digit) or country-specific (8+ digit) HS codes. The bulk classification request limit is based on the AWS 90-second timeout, which ends up being about 2,000 classifications.