Returns a suggested Harmonized System (HS) code for a product based on its description, a provided HS code, or both. Optionally, you can specify destination countries for more accurate classification. Accurate HS codes are essential for customs clearance, duties, and shipping restrictions.

Use Case

Use this endpoint before quoting or labeling international shipments to ensure your items are correctly classified. It helps merchants, marketplaces, and logistics systems automatically assign HS codes to products so they can generate commercial invoices, comply with customs regulations, and simplify tariff calculations.

Required Inputs

At least one of the following is required:

Product description: A clear, descriptive text that details what the product is made of and how it is used.
hsCodeProvided: A customer or third-party provided HS code to guide the classification. When provided, the classification will use this code as a reference.

Optional Inputs

shipToCountries: An array of destination country codes where the product will be shipped.
includeAlternatives: Boolean flag to include alternative HS code suggestions (default: true).

Notes

The returned HS code is a recommendation; verify with official customs sources because classifications may vary by country.
Provide detailed and specific descriptions for more accurate results.
When using hsCodeProvided, the API will validate and enrich the classification based on the provided code.
Use this endpoint together with the Create Commercial Invoice endpoint to populate item classifications.
Final responsibility for correct classification lies with the shipper or merchant.