Universal (6-digit) classifications
If you’re looking to classify items to the universal (6-digit) WCO HS code, use the example below.
GraphQL
REST
The input takes a list so you can request many or a single classification at once.
MUTATION
GraphQL
1
2
3
4
5
6
7
8
9
10
11
mutation ClassificationsCalculate($inputs: [ClassificationCalculateInput!]!) {
classificationsCalculate(input: $inputs) {
id
name
categories
imageUrl
hsCode {
code
}
}
}
VARIABLES
JSON
1
2
3
4
5
6
7
8
9
{
"inputs": [
{
"categories": "women's clothing",
"imageUrl": "https://zonos.com/images/cozygloves.png",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
}
]
}
RESPONSE
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"data": {
"classificationsCalculate": [
{
"id": "classification_8C49fk2945jmm232CcQtHtXdu",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"categories": "women's clothing",
"imageUrl": "https://zonos.com/images/cozygloves.png",
"hsCode": {
"code": "6116.10"
}
}
]
}
}
Country specific (8+ digit) classifications
The benefits of classifying to a country-specific code include improved restricted item management, reduced tax rates, preferential duty rates, and smoother customs clearance.
To request classifications to specific countries, add the countries' ISO codes in the Classify request as seen in the example below.
GraphQL
REST
The input takes a list so you can request many or a single classification at once.
Mutation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
mutation ClassificationsCalculate($inputs: [ClassificationCalculateInput!]!) {
classificationsCalculate(input: $inputs) {
id
name
categories
imageUrl
configuration {
shipToCountries
}
hsCode {
code
countryCode
}
}
}
Variables
1
2
3
4
5
6
7
8
9
10
11
12
{
"inputs": [
{
"categories": "women's clothing",
"imageUrl": "https://zonos.com/images/cozygloves.png",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"configuration": {
"shipToCountries": ["CA", "KR"]
}
}
]
}
Response
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
{
"data": {
"classificationsCalculate": [
{
"id": "classification_8C49fk2945jmm232CcQtHtXdu",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"categories": "women's clothing",
"imageUrl": "https://zonos.com/images/cozygloves.png",
"configuration": {
"shipToCountries": ["CA", "KR"]
},
"hsCode": {
"code": "6116.10.0020",
"countryCode": "CA"
}
},
{
"id": "classification_8C49fk2945jmm232CcQtHtXdu",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"categories": "women's clothing",
"imageUrl": "https://zonos.com/images/cozygloves.png",
"configuration": {
"shipToCountries": ["CA", "KR"]
},
"hsCode": {
"code": "6116.10.2030",
"countryCode": "KR"
}
}
]
}
}
Possible Classify API responses
GraphQL
REST
- When
hsCodeis returned with a 6 to 8+ digit HS code, depending on whether or not a ship-to country was included in the request, your classification request was successful. - When
{"errors": [ { "message": "No adequate response"}]}is returned, that means Classify could not find a classification due to insufficient input information.
Classifying items
Examples of universal and country-specific classifications.The examples below show how to generate classifications for products to the universal (6-digit) and country-specific (8+ digit) levels. Learn about the differences between universal and country-specific HS codes.