API · /hscodes-api

HS Codes API

healthy 4,098 Subscribers

The World Customs Organization Harmonized System (HS) as an API — 6,900+ commodity classification codes used for customs, tariffs and international trade. Look up any HS code (2-digit chapter, 4-digit heading or 6-digit subheading) with its description and full ancestor chain, search the nomenclature by product, or drill into the sub-codes of a code. Ideal for logistics, customs, e-commerce and trade-compliance tooling.

api.oanor.com/hscodes-api
Get an API key Try in playground → Contact provider

Machine-readable spec so AI agents can integrate this API.

/api/hscodes-api/openapi.json
/api/hscodes-api/llms.txt

Discovery: GET /api/index.json lists every API.

API health

healthy
Uptime
100.00%
Server probes · 24h
Avg latency
118 ms
Server probes · 24h
Subscribers
4,098
active
Total calls
304
last 7 days
status Full status page → · 24 probes/24h

Pricing

Pick a tier — billed monthly, cancel anytime.

Free

Free

  • 2,000 calls / month
  • 2 requests / second
  • Hard cap (429 above quota, no overage)
  • 2,000 calls/month
  • 2 req/sec
  • Lookup + search + children
  • No credit card
Sign in to subscribe

Starter

€9.00 /month

  • 45,000 calls / month
  • 8 requests / second
  • Hard cap (429 above quota, no overage)
  • 45k calls/month
  • 8 req/sec
  • Hierarchy & level filters
  • Email support
Sign in to subscribe

Pro

€25.00 /month

  • 275,000 calls / month
  • 20 requests / second
  • Hard cap (429 above quota, no overage)
  • 275k calls/month
  • 20 req/sec
  • Customs / logistics tooling
  • Priority support
Sign in to subscribe

Mega

€65.00 /month

  • 1,100,000 calls / month
  • 50 requests / second
  • Hard cap (429 above quota, no overage)
  • 1.1M calls/month
  • 50 req/sec
  • Trade-compliance platform
  • Dedicated SLA
Sign in to subscribe

Built by

Related APIs

Other APIs with overlapping tags.

UN/LOCODE API

The UN/LOCODE registry (United Nations Code for Trade and Transport Locations) as an API — 116,000+ ports, airports, rail and road terminals and trade points across 249 countries. Resolve any 5-character code (e.g. USNYC → New York; DEHAM → Hamburg; NLRTM → Rotterdam) to its name, country, subdivision, transport functions (port, rail, road, airport, postal, …), IATA code and coordinates; search locations by name with country and function filters; or list every location in a country. UN/LOCODE is the standard used in shipping, logistics, customs and EDI. Ideal for supply-chain, freight, trade-compliance and logistics software.

api.oanor.com/locode-api

Seaports API

The NGA World Port Index (WPI / Pub 150) as an API — 3,800+ maritime ports across 195 countries. Look up any port by its WPI number (e.g. 31140 → Rotterdam) or UN/LOCODE (e.g. NLRTM); search by name, country, harbor size or water body; or find every port within a radius of any coordinate (great-circle distance). Each record carries the UN/LOCODE, country, coordinates, harbor size and type, channel/anchorage/pier depths, maximum vessel length and draft, plus facility flags (container, oil/LNG terminal, ro-ro, dry dock, …). Ideal for shipping, logistics, maritime and supply-chain tools.

api.oanor.com/seaports-api

Seaports API

Search a database of 17,000+ seaports worldwide from UN/LOCODE. Find ports by name and country, look one up by its UN/LOCODE, or find all ports near a coordinate (radius search). Each record includes the UN/LOCODE, coordinates, country and connected transport modes (rail, road, airport) — ideal for shipping, freight, supply-chain and logistics applications.

api.oanor.com/ports-api

Frequently asked questions

Quick answers about pricing, quotas, and integration.

How do I get an API key for HS Codes API?
Sign up for free at oanor.com, generate an API key from the developer dashboard, and call HS Codes API with the x-oanor-key header. No credit card needed for the free tier.
What's the rate limit for HS Codes API?
Free tier allows 1 request per second. Paid plans scale up to 50 requests per second on the Mega tier. Hard limits return HTTP 429 above the quota — no surprise overage charges.
How much does HS Codes API cost?
HS Codes API has a free tier with 100 calls / month. Paid plans start at €9.00 / month with higher quotas and faster rate limits.
Can I cancel my subscription anytime?
Yes. Plans are billed monthly and you can cancel anytime from your billing dashboard. No long-term contracts and no cancellation fee.
Is HS Codes API GDPR-compliant?
All requests to HS Codes API go through our EU-based gateway. Your upstream API key never leaves our server and no personal data is shared with the upstream provider beyond the request you send.

Pick an endpoint from the list on the left to see its details and try it.

Code snippets

Sign up to get an API key, then call any path under your slug.

curl https://api.oanor.com/hscodes-api/SOME_PATH \
  -H "x-oanor-key: oanor_test_..."
const res = await fetch("https://api.oanor.com/hscodes-api/SOME_PATH", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();
$ch = curl_init("https://api.oanor.com/hscodes-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);
import requests
r = requests.get(
    "https://api.oanor.com/hscodes-api/SOME_PATH",
    headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())

Ratings

Sign in to rate.

No reviews yet.

Discussion

Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.

Sign in to start a thread or reply.

Sign in

New thread

/ 4000

📌 Pinned 🔒 Locked

·

· ·

/ 4000

🔒 This thread is locked — no new replies.

  • No threads yet — start the discussion.

Support

Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.

Sign in to open a support ticket.

Sign in

Open new ticket

Describe what you need help with. The provider team gets an email and replies on the ticket page.

  • No tickets yet for this API.

Subscription active — calls can start immediately.

Send your first request —

Subscription active — copy a snippet and fire off your first call.