Get HS Codes Across Countries

Returns full-length HS/HTS tariff codes for a single item across multiple destination countries in a single request. This bulk API is useful for global classification needs, allowing businesses to prepare items for international shipping and customs compliance across regions.

SecuritybearerAuth

Request

header Parameters

X-PB-TransactionId	string A unique Transaction ID provided by the partner, which is used to enable debugging and linking between the client's transaction and the system. Allowed characters limit is 36.
Content-Type required	string The media type of the request body. Value: "application/json"

Request Body schema: application/json

destinationCountryCodes required	Array of strings List of destination country codes to classify the item for. Each must be a valid ISO 3166-1 alpha-2 or alpha-3 code (e.g., "CA", "USA"). Maximum 250 coutries can be passed in the list.
pricingCurrencyCode	string The currency used for the item price. It must be a valid ISO 4217 currency code (e.g., USD, EUR). This field is required only if the item price is provided in the request.
required	object Details of the item to be classified.

Responses

200

The requested HS Code has been retrived successfully.

400

Invalid request.

401

The request could not be authorized.

500

The request could not be completed due to an internal error.

post/api/v1/crossborder-services/hsclassification/bulk

Request samples

application/json

{"destinationCountryCodes": ["CA",
"CL"
],
"pricingCurrencyCode": "USD",
"item": {"itemId": "itemid-11",
"name": "Fisher Price Tricycle",
"description": "The Fisher-Price Grow-With-Me Girls' Tricycle is the perfect first ride for little adventurers aged 2–5.",
"categoryPath": "Toys & Games/Other Toys & Games",
"imageURL": "www.client.com/ITEM11.png",
"productURL": "www.client.com/ITEM11",
"attributes": [{"name": "gender",
"value": "girls"
},
{"name": "material",
"value": "steel"
},
{"name": "brand",
"value": "Fisher-Price"
}
],
"unitPrice": 100,
"weight": {"value": 3,
"unitOfMeasurement": "LB"
}
}
}

Response samples

application/json

{"item": {"itemId": "itemid-11",
"hsClassifications": [{"destinationCountryCode": "CA",
"hsTariffCode": "9503009099",
"tariffDescription": "Toys, games and sports requisites; parts and accessories thereof Tricycles, scooters, pedal cars and similar wheeled toys; dolls' carriages; dolls; other toys; reduced-size ('scale') models and similar recreational models, working or not; puzzles of all kinds. Other Other: Other",
"confidenceLevel": "HIGH"
},
{"destinationCountryCode": "CL",
"hsTariffCode": "95030099",
"tariffDescription": "Toys, games and sports requisites; parts and accessories thereof Tricycles, scooters, pedal cars and similar wheeled toys; dolls' carriages; dolls; other toys; reduced-size ('scale') models and similar recreational models, working or not; puzzles of all kinds. other other",
"confidenceLevel": "HIGH"
}
]
}
}