Universal codes (6-digit)
Supply as many item details as possible to get an accurate HS code. While only item descriptions are required to return HS codes, additional item information (image URL, categories, etc.) will provide improved classifications.
Zonos Bulk Classify allows you to classify your entire catalog or bulk requests simultaneously.
Recommended: We highly recommend supplying an
id
for each item in your bulk classification request. This allows for more efficient and faster processing.
POST https://api.zonos.com/v1/classify/bulk
Request
{
"items": [
{
"item": {
"id": "29342",
"amount": "12.99 USD",
"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"
}
},
{
"item": {
"id": "29343",
"amount": "19.99 USD",
"brand": null,
"category": null,
"description": "Cadet Army Cap Basic Everyday Military Style Hat",
"detail": null,
"gender": "men's",
"hs_code": "6505",
"image_url": "https://zonos.com/images/cadethat.png",
"item_age": null,
"language_code": "en",
"material": null,
"product_id": "895669256378",
"subcategory": null
}
},
{
"item": {
"id": "29344",
"amount": "45.29 USD",
"brand": "Ray Ban",
"category": "Accessories",
"description": "Vintage Aviator Square Sunglasses",
"detail": null,
"gender": null,
"hs_code": "9004",
"image_url": "https://zonos.com/images/vintagesunglasses.png",
"item_age": null,
"language_code": "en",
"material": null,
"product_id": "895669256399",
"subcategory": "Sunglasses"
}
}
]
}
Response
{
"items": [
{
"id": "29342",
"hs_code": "6116.99",
"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": "Other: Of other textile materials",
"combinedDescription": "Gloves, mittens and mitts, knitted or crocheted: of other textile materials",
"truncatedCombinedDescription": "Gloves, mittens and mitts, knitted or crocheted"
},
{
"id": "29343",
"hs_code": "6505.00",
"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": "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.",
"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.",
"truncatedCombinedDescription": "Hats and other headgear, knitted or crocheted"
},
{
"id": "29344",
"hs_code": "9004.10",
"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,"
}
]
}
Country-specific codes (8+ digit)
To request a country-specific (eight+ digit codes), add the ship-to country/countries at the end of your Classify request. The benefits of classifying to the country-specific code include improved restricted item management, reduced tax rates, preferential duty rates, and smoother customs clearance.
POST https://api.zonos.com/v1/classify/bulk
Request
{
"items": [
{
"item": {
"id": "29342",
"amount": "12.99 USD",
"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",
"language_code": "en",
"material": "cotton",
"product_id": "895669256385",
"subcategory": "women's accessories"
}
},
{
"item": {
"id": "29343",
"amount": "19.99 USD",
"brand": null,
"category": null,
"description": "Cadet Army Cap Basic Everyday Military Style Hat",
"detail": null,
"gender": "men's",
"hs_code": "6505",
"image_url": "https://zonos.com/images/cadethat.png",
"language_code": "en",
"material": null,
"product_id": "895669256378",
"subcategory": null
}
},
{
"item": {
"id": "29344",
"amount": "45.29 USD",
"brand": "Ray Ban",
"category": "Accessories",
"description": "Vintage Aviator Square Sunglasses",
"detail": null,
"gender": null,
"hs_code": "9004",
"image_url": "https://zonos.com/images/vintagesunglasses.png",
"language_code": "en",
"material": null,
"product_id": "895669256399",
"subcategory": "Sunglasses"
}
}
],
"ship_to_countries": ["CA", "FR"]
}
Response
{
"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,"
}
]
}
Bulk classification
Dynamically harmonize your products with Zonos Classify.Zonos Classify allows you to classify your items in bulk, either universally or to a specific country with our machine learning-built tool that generates instant, accurate (HS) codes with as little as an item description.
Classifying your products will typically improve your landed cost calculation when an import is over the duty de minimis, and a simplified duty is not available. It will also help flag restricted items, assign accurate duty and tax rates, and ensure compliance for a smooth customs clearance process.