Single Lookup

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

string

required

The search term to initiate a HS code search

integer

default:2

Switch between 2 search modes:

1 for HS code only search
2 for full search mode (default mode)

string

default:"wco"

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": "18069005",
            "wco": "180690",
            "description_en": "Chocolate and other food preparations containing cocoa: > Other: > Other:",
            "hierarchy": {
                "section": {
                    "section": "IV",
                    "section_title": "Prepared foodstuffs; beverages, spirits and vinegar; tobacco and manufactured tobacco substitutes"
                },
                "chapter": {
                    "chapter_code": "18",
                    "chapter_description_en": "COCOA AND COCOA PREPARATIONS"
                },
                "heading": {
                    "heading_code": "1806",
                    "heading_description_en": "Chocolate and other food preparations containing cocoa:"
                }
            },
            "direction": "import",
            "country": "US",
            "source": "USITC United States International Trade Commission",
            "version": "2025",
            "last_updated": "05-2026"
        },
	{...}
  ]
}

Fields Descriptions

Each HS code object in the response contains the following fields:

string

The country-specific HS code for the product, based on the country parameter in the query

string

The WCO 6 digits HS code for the product

string

Country-specific description of the HS code from the tariff schedule

object

default:2

The classification hierarchy this code belongs to

string

Two-letter ISO country code. Example: “US”, “CA”

string

The data source of this HS code.

string

The HS nomenclature version based on WCO release schedule. Example: “2022”, “2027”

string

Whether this code applies to imports or exports. Example: “import”, “export”

string

The last time we updated this HS code data from the official source.

Getting started

API Reference

Parameters

Rate Limits & Errors

HTTP Request

URL Parameters

Example Response

Fields Descriptions

​HTTP Request

​URL Parameters

​Example Response

​Fields Descriptions

HTTP Request

URL Parameters

Example Response

Fields Descriptions