DOCS

Request a bulk classification

/

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.

Note: To obtain a classification, you must provide a description. It's up to you which field(s) you choose to provide, but we recommend you provide as much information as possible to receive a more accurate classification.

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.

FieldNotes
items REQUIREDList of items being exported to be classified.
item[index].item.age OPTIONALThe age of the item. E.g., “1784-1820” or “3rd Century A.D.”
items[index].item.amount OPTIONALThe price of the item.
items[index].item.brand OPTIONALThe brand of the item.
items[index].item.category OPTIONALThe item category.
items[index].item.description REQUIREDThe 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 OPTIONALAdditional features, attributes, or descriptions of the item.
items[index].item.gender OPTIONALThe gender reference associated to the item.
items[index].item.hs_code OPTIONALAs 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 OPTIONALThe image URL.
items[index].item.language_code OPTIONALThe ISO 639-1 language code. If null, English is the default language.
item[index].material OPTIONALThe material composition of the item.
item[index].product_id OPTIONALThe merchant or exporter’s unique item identifier for the product.
item[index].sub_category OPTIONALThe category most closely associated with the item.
ship_to_countriesOPTIONALThe 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,"
    }
  ]
}

Was this page helpful?