Skip to main content
The Single HS Code Lookup endpoint allows you to search for one HS code at a time. This is perfect for real-time lookups, interactive search features, or when you are classifying based on a single detailed query.

​
HTTP Request

GET https://api.hsping.com/api/v1/find

​
URL Parameters

​
query
string
required
The search term to initiate a HS code search
​
query_type
integer
default:2
Switch between 2 search modes: HS code only OR full search mode
​
country
string
Two-letter ISO country code. Example: “US”, “CA”.Default to WCO 6 digits standard if not specified.

​
Example Response

{
  "query": "chocolate",
  "query_type": 1,
  "country": "us",
  "count": 10,
  "results": [
    {
      "hscode": "1806901000",
      "wco": "180690",
      "description_en": "Chocolate, in blocks, slabs or bars",
      "country": "US",
      "source": "string",
      "version": "string",
      "last_updated": "11-2025"
	  "direction": "string",
    },
	{...}
  ]
}

​
Fields Descriptions

Each HS code object in the response contains the following fields:
​
hscode
string
The country-specific HS code for the product, based on the country parameter in the query
​
wco
string
The WCO 6 digits HS code for the product
​
description_en
integer
default:2
Country-specific description of the HS code from the tariff schedule
​
country
string
Two-letter ISO country code. Example: “US”, “CA”
​
source
string
The data source of this HS code.
​
version
string
The HS nomenclature version based on WCO release schedule. Example: “2022”, “2027”
​
direction
string
Whether this code applies to imports or exports. Example: “import”, “export”
​
last_updated
string
The last time we updated this HS code data from the official source.