HS Code API: Country-Specific HS & HTS Lookup in 5 Minutes

Easily access multi-country HS code in minutes; with just one endpoint, and an API key. Start with 100 free lookups — no credit card, no sales call, no procurement thread.

100 free lookups · No credit card · One click cancel or change plan


$ curl -H "Authorization: Bearer $HSPING_KEY" \
"api.hsping.com/api/v1/find?query=wooden+furniture&country=CA"


{
"
query": "wooden furniture",
"query_type": "2",
"
country": "CA",
"
count": 10,
"
results": [{
"
hscode": "9403609000",
"
wco": "940360",
"
description_en": "Other wooden furniture",
"hierarchy": {...},
"
source": "CBSA Canada Border Services Agency",
"
version": "2026"
}, ...]
}

HS and HTS Data, Straight from the Sources

WCO logo
USITC logo
Canada CBSA logo
Singapore Customs logo

Sign up with an email

No credit card, no sales call.

Your account arrives with 100 free HS Code lookups.

Copy your API key

Ready on screen the moment you land on the HS Ping dashboard.

Just give it a name and one-click copy it.

Make the call

Paste the cUrl command into your terminal — or open our public Postman workspace, drop your key in and hit Send. See a real response before you code.

One HS code lookup endpoint for 35 countries

/find takes a keyword, or an (sometimes partial) HS code input and finds you the best matched classifications.

$ curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.hsping.com/api/v1/find?query=wooden furniture&country=CA"

query=9403.60&<strong>query_type=1</strong>

You have a code from suppliers.
Code-only search. Verify it, expand it, or check that it’s still current in this year’s edition.


query=wooden furniture

You have a product description.
Ranked matching codes, each with its full section → chapter → heading hierarchy.


query=wooden furniture&<strong>query_type=2</strong>

You want everything to see all relevant matches.
Full search across codes and descriptions at once.


country=CA

You need HS code matches only from specific country (in this case, Canada).

HS Code JSON you can read without the docs open.

Build faster and debug smarter with our HS-code-focused API responses.

{
   "hscode": "9403609000",
   "wco": "940360",
   "description_en": "Other furniture and parts thereof. > Other wooden furniture > Other",
   "hierarchy": {
      "section": {
            "section": "XX",
            "section_title": "Miscellaneous manufactured articles"
            },
      "chapter": {
            "chapter_code": "94",
            "chapter_description_en": "FURNITURE"
            },
      "heading": {
            "heading_code": "9403",
            "heading_description_en": "Other furniture and parts thereof."
            }
         },
   "direction": "import",
   "country": "CA",
   "source": "CBSA Canada Border Services Agency",
   "version": "2026",
   "last_updated": "05-2026"   
}

hscode · wco

The country-specific code with its national extensions, and the universal 6-digit base it rolls up to — so you can join across borders without re-querying.


hierarchy

Section, chapter and heading come back with the code. No second call to work out where it sits.


source · version · last_updated

Which authority published it, which HS edition it belongs to, and when we last checked it against the source. This is what makes a stored code auditable six months later, when someone asks where the number came from.

1 → n

Batch endpoint

Send many queries in one request and get the same result objects back — same fields, same shape. Nothing new to parse.

1,000 / min

On every plan

Including the cheapest one. Rate limits aren’t a lever we use to upsell you.

2M

Lookups a month, top plan

Same response shape and same behaviour whether it’s your first call or your millionth.

Pricing you can work out before you commit.

Three plans, published in full. No “contact sales” tier, no negotiated rate you only find out about after a call.

Professional

$49

For production workflows where stability and consistency matters.

✓ 100 free lookups (one-time)
✓ 50K lookups / month
✓ Rate limit: 1,000 lookups / minute
✓ 256-bit Encrypted API

Volume

$129

For high-volume lookup looking for consistent response behavior.

✓ 100 free lookups (one-time)
✓ 500K lookups / month
✓ Rate limit: 1,000 lookups / minute
✓ 256-bit Encrypted API

Scale

$299

For teams processing HS codes at scale and minimizing operational risk.

✓ 100 free lookups (one-time)
✓ 2M lookups / month
✓ Rate limit: 1,000 lookups / minute
✓ 256-bit Encrypted API

Cross-border checkout

Attach a destination-country HS code to an order before it ships, at the moment the cart is confirmed.

Forwarders & brokers

Take manual lookup time out of entry preparation, without leaving the tools your ops team already uses.

ERP & catalogue enrichment

Backfill classification references across thousands of SKUs with the batch endpoint, overnight.

Compliance & audit tooling

Store the code with its source, edition and check date, so the file defends itself when someone asks.

HS code API FAQ

What is HS Ping

HS Ping is a country-specific HTS and HS code API that lets developers setup HS code lookup in your application easily within 5 minutes. There is no credit card needed to setup and trial run (100 free lookups available).

Is there a free plan for HS Ping?

We don’t currently offer a permanent free tier.

However, you are free to try out our API with 100 free trial lookups available for you instantly when you sign up. Once they run out, you will need to subscribe to a plan to continue using HS Ping.

What happens if I hit my monthly limit?

Lookups stop until your next monthly reset, or until you move up a plan. We don’t meter overage, so you’re never billed more than your plan price.

Do my HS code API credits expire?

Yes, paid plan credits do expire and reset monthly.

Your 100 trial lookups are one-time credits for you to test out our API.

Can I use this commercially?

Yes. You can use HS Ping anywherel including your internal systems, customer-facing products, and tools you resell are all fine.

What happens at the next WCO revision?

We carry the new edition when it publishes, and endpoints stay versioned, so your integration keeps behaving exactly as it does today until you decide to move.

Which countries are supported?

HS Ping supports 35 countries today; including the US, Canada, UK, Singapore, Australia, Argentina, Mexico, Brazil and the EU TARIC members — plus the standard WCO 6-digit base.

More are being added; the coverage page always has the current list.

Scroll to Top