Look up or validate a Harmonized System (HS) code for a product using its description or a known HS code. The endpoint returns the best-matching HS code along with a confidence score and product classification details.

When to use: Call this endpoint when preparing international shipments and you need the correct HS code for customs declarations, commercial invoices, or duty/tax estimation.

Prerequisites:

• Valid JWT authentication token (Bearer)
• At least one of: a product text description (description) or an existing HS code to validate (hsCodeProvided)

Key behaviors:

• Powered by the Zonos classification engine for accurate tariff lookup
• Returns a confidence score — low-confidence results should be reviewed manually
• You can optionally provide destination country codes to get country-specific classifications
• If both description and hsCodeProvided are supplied, the API cross-references them for higher accuracy
• Use the returned HS code in the /ship/commercial-invoice and /ship/generate/ endpoints for international shipments