Look Up HTS Code

GET/v1/hs/lookup/{htsNumber}$0.01 per call

Look up a specific HTS number with all matching tariff lines.

Parameters

Name	In	Type	Description
htsNumberrequired	path	string	HTS number or prefix (e.g. 8471)

Response fields

Field	Type	Description
success	boolean	e.g. `true`
data	object
data.htsNumber	string	e.g. `8471.30.01.00`
data.totalResults	number	e.g. `1`
data.results	array
data.results[].htsNumber	string	e.g. `8471.30.01.00`
data.results[].description	string	e.g. `Portable automatic data processing machines, weighing not mor…`
data.results[].indent	number	e.g. `1`
data.results[].generalDutyRate	string	e.g. `Free`
data.results[].specialDutyRate	null
data.results[].otherDutyRate	string	e.g. `35%`
data.results[].units	array
data.results[].chapter	string	e.g. `84`
data.results[].heading	string	e.g. `8471`
data.results[].subheading	string	e.g. `847130`
meta	object
meta.dataSource	object
meta.dataSource.name	string	e.g. `ComplianceGrid`
meta.dataSource.provenance	string	e.g. `computed`

Fields are read from a real response captured 2026-11-04. Optional fields may be absent in other responses.

Errors

400 invalid request
401 missing or bad key
403 not in your plan
429 rate limited, see Retry-After
402 payment required
5xx retry with backoff

Error bodies and codes are described in Error codes and troubleshooting.

curl "https://api.compliancegrid.ai/v1/hs/lookup/8471.30.01.00" \
  -H "Authorization: Bearer $CG_API_KEY"

Try it in the sandbox

Runs against sandbox.api.compliancegrid.ai with your own sandbox key, which stays in this browser. Sandbox responses are mock data. Get a free key.

Sandbox key

Remember for this tab

htsNumber (path, required)

Example response · captured from production 2026-11-04

{
  "success": true,
  "data": {
    "htsNumber": "8471.30.01.00",
    "totalResults": 1,
    "results": [
      {
        "htsNumber": "8471.30.01.00",
        "description": "Portable automatic data processing machines, weighing not more than 10 kg, consisting of at least a central processing unit, a keyboard and a display",
        "indent": 1,
        "generalDutyRate": "Free",
        "specialDutyRate": null,
        "otherDutyRate": "35%",
        "units": [
          "No."
        ],
        "chapter": "84",
        "heading": "8471",
        "subheading": "847130"
      }
    ]
  },
  "meta": {
    "dataSource": {
      "name": "ComplianceGrid",
      "provenance": "computed"
    }
  }
}