HS Codes API

Search and look up Harmonized System codes.

Search HS Codes

GET /api/v1/hs-codes/search

Query Parameters

Parameter	Type	Required	Description
q	string	Yes	Search query (description or code prefix)
country	string	No	ISO 3166-1 alpha-2 country code (e.g., US, DE, GB)
limit	number	No	Max results (default: 20, max: 100)

Response

{
  "results": [
    {
      "code": "8542.31.0000",
      "description": "Electronic integrated circuits: Processors and controllers",
      "country": "US",
      "chapter": "85",
      "duty_rate": "Free"
    },
    {
      "code": "8542.32.0000",
      "description": "Electronic integrated circuits: Memories",
      "country": "US",
      "chapter": "85",
      "duty_rate": "Free"
    }
  ],
  "total": 2
}

Get HS Code Details

GET /api/v1/hs-codes/:code

Query Parameters

Parameter	Type	Required	Description
country	string	No	Country for national extensions

Response

{
  "code": "8542.31.0000",
  "description": "Electronic integrated circuits: Processors and controllers",
  "country": "US",
  "chapter": "85",
  "heading": "8542",
  "subheading": "8542.31",
  "duty_rate": "Free",
  "hierarchy": [
    { "level": 2, "code": "85", "description": "Electrical machinery and equipment" },
    { "level": 4, "code": "8542", "description": "Electronic integrated circuits" },
    { "level": 6, "code": "8542.31", "description": "Processors and controllers" },
    { "level": 10, "code": "8542.31.0000", "description": "Processors and controllers (US)" }
  ]
}