HS Code API: Country-Specific HS & HTS Lookup in 5 Minutes
35 countries · Official Sources
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
GET /api/v1/find
$ 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
Getting Started
From Signup to your first HS code,
in Five Minutes.
All you need to get started is a valid email address, not even a password.
STEP 01
Sign up with an email
No credit card, no sales call.
Your account arrives with 100 free HS Code lookups.
STEP 02
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.
STEP 03
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.
THE ENDPOINT
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).
THE RESPONSE
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.
DATA & PROVENANCE
HS Code Data, Officially Sourced
Built for teams where a wrong classification has consequences — customs delays, penalties, an audit six months from now.
Sources
Official authorities only
USITC, CBSA, EU TARIC, HMRC, Singapore Customs and their counterparts — named in every result, never aggregated from third-party scrapes.
Labelling
Versioned and dated
Each result declares its HS edition and the date we last checked it. You always know how old a number is.
STABILITY
Versioned endpoints
You’re on /api/v1. When the next WCO revision lands, your integration keeps returning what it returned yesterday until you choose to move.
Security
256-bit SSL, every request
Encrypted in transit, no exceptions, on every plan including the trial.
Coverage
35 countries and counting
US, Canada, UK, Singapore, Australia, Mexico, Brazil, Argentina and the EU TARIC members, plus the standard WCO 6-digit base.
Scope
Lookup, not classification
We return official references. Deciding what your product is stays with you or your licensed broker — and we’d rather say so than imply otherwise.
SCALE
HS Code Lookup at Any Scale
The same API that answers a single search at checkout will backfill a catalogue overnight.
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
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
100 free lookups when you sign up
One-time, no credit card. Change plans, or one-click cancel from your account settings as you want.
IN PRODUCTION
Built for eCommerce Checkouts, ERPs, and More.
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.
FREQUENTLY ASKED QUESTIONS
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.
Your first HS code is about five minutes away.
An email gets you an API key and 100 free lookups across 35 countries. No card, no call, nothing to cancel if you change your mind.