Search Tariffs

GEThttps://api-tariff-codes.dataandapis.com/v1/tariffs

Search Tariffs is an endpoint of the Tariff Codes API. All 35,804 lines of the US Harmonized Tariff Schedule with duty rates, searchable.

Send your key in the X-Api-Key header. Each call costs 1 token; a free key includes 500 tokens a month.

Get a free API key Try it in the browser

Request

Query parameters

Parameter	Example
chapter	85	Optional
code		Optional
leaves_only	true	Optional
limit	25	Optional
page	1	Optional
q	smartphones	Optional

Example request

curl

curl "https://api-tariff-codes.dataandapis.com/v1/tariffs?chapter=85&leaves_only=true&limit=25&page=1&q=smartphones" \
  -H "X-Api-Key: YOUR_API_KEY"

Node.js

const res = await fetch("https://api-tariff-codes.dataandapis.com/v1/tariffs?chapter=85&leaves_only=true&limit=25&page=1&q=smartphones", {
  headers: { "X-Api-Key": process.env.DATAANDAPIS_KEY },
});
const data = await res.json();

Python

import os, requests

r = requests.get(
    "https://api-tariff-codes.dataandapis.com/v1/tariffs?chapter=85&leaves_only=true&limit=25&page=1&q=smartphones",
    headers={"X-Api-Key": os.environ["DATAANDAPIS_KEY"]},
)
data = r.json()

Example response

{
  "ok": true,
  "page": 1,
  "limit": 5,
  "total": 15,
  "total_pages": 3,
  "tariffs": [
    {
      "seq": 27788,
      "htsno": "8517.13.00.00",
      "indent": 2,
      "description": "Smartphones",
      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks",
      "chapter": "85",
      "is_leaf": true,
      "units": [
        "No."
      ],
      "general": "Free",
      "special": null,
      "other": "35%",
      "quota_quantity": null,
      "additional_duties": null,
      "footnotes": [],
      "updated_at": "2026-09-06 05:06:09"
    },
    {
      "seq": 27794,
…

Show full response

{
  "ok": true,
  "page": 1,
  "limit": 5,
  "total": 15,
  "total_pages": 3,
  "tariffs": [
    {
      "seq": 27788,
      "htsno": "8517.13.00.00",
      "indent": 2,
      "description": "Smartphones",
      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks",
      "chapter": "85",
      "is_leaf": true,
      "units": [
        "No."
      ],
      "general": "Free",
      "special": null,
      "other": "35%",
      "quota_quantity": null,
      "additional_duties": null,
      "footnotes": [],
      "updated_at": "2026-09-06 05:06:09"
    },
    {
      "seq": 27794,
      "htsno": "8517.18.00.10",
      "indent": 3,
      "description": "Videophones",
      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks > Other",
      "chapter": "85",
      "is_leaf": true,
      "units": [
        "No."
      ],
      "general": null,
      "special": null,
      "other": null,
      "quota_quantity": null,
      "additional_duties": null,
      "footnotes": [],
      "updated_at": "2026-09-06 05:06:09"
    },
    {
      "seq": 27796,
      "htsno": "8517.18.00.50",
      "indent": 3,
      "description": "Other",
      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks > Other",
      "chapter": "85",
      "is_leaf": true,
      "units": [
        "No."
      ],
      "general": null,
      "special": null,
      "other": null,
      "quota_quantity": null,
      "additional_duties": null,
      "footnotes": [],
      "updated_at": "2026-09-06 05:06:09"
    },
    {
      "seq": 27787,
      "htsno": "8517.11.00.00",
      "indent": 2,
      "description": "Line telephone sets with cordless handsets",
      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks",
      "chapter": "85",
      "is_leaf": true,
      "units": [
        "No."
      ],
      "general": "Free",
      "special": null,
      "other": "35%",
      "quota_quantity": null,
      "additional_duties": null,
      "footnotes": [],
      "updated_at": "2026-09-06 05:06:09"
    },
    {
      "seq": 27795,
      "htsno": "8517.18.00.20",
      "indent": 3,
      "description": "Multiline telephones (including key, call director and consoles)",
      "context": "Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks; other apparatus for the transmission or reception of voice, images or other data, including apparatus for communication in a wired or wireless network (such as a local or wide area network), other than transmission or reception apparatus of heading 8443, 8525, 8527 or 8528; parts thereof > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks > Other",
      "chapter": "85",
      "is_leaf": true,
      "units": [
        "No."
      ],
      "general": null,
      "special": null,
      "other": null,
      "quota_quantity": null,
      "additional_duties": null,
      "footnotes": [],
      "updated_at": "2026-09-06 05:06:09"
    }
  ]
}

Other endpoints in the Tariff Codes API

Full Tariff Codes API documentation →