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.GraphQL
Below, you'll find examples of generating classifications for products at both the universal (6-digit) and country-specific (8+ digit) HS code levels. Understand the differences between universal and country-specific HS codes.
For those seeking more comprehensive technical details and extensive documentation, visit our Zonos GraphQL API reference developer site. This comprehensive resource offers detailed insights into API endpoints, GraphQL mutations, and extensive technical information.