---
title: "Look up one HTS code (also GET /hts/{code})"
method: POST
path: "/api/hts"
tags: ["Dutyfinch"]
---

# Look up one HTS code (also GET /hts/{code})

`POST /api/hts`

## Request

- Base URL: `https://dutyfinch.cybermaxtools.com`
- URL: `https://dutyfinch.cybermaxtools.com/api/hts`
- Auth: one of:
  - none
  - API key in header `x-api-key`
  - HTTP bearer

Description and full description path, general / special / column 2 duty rates (10-digit lines inherit from their 8-digit parent), units, footnotes, Section 301 China status (list, additional rate, status in_effect / upcoming / suspended / expired, exclusions with end dates), the 2026 US–China reduction flag, child lines and the HTS release the answer comes from.

## Request body

- object
  - `code` string, required

## Response `200`

Results (same field names as the bulk version's dataset records) plus the free-tier limits.

- object

## Other responses

- `400`: Invalid input
- `401`: Invalid or revoked API key
- `429`: Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.
- `504`: Took too long; ask for fewer items

---

[API](https://skmtc.dev/cybermaxtools/apis/dutyfinch-api.md) · [All operations](https://skmtc.dev/cybermaxtools/apis/dutyfinch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cybermaxtools/apis/dutyfinch-api/revisions/e333c51ba697?raw)