HS/HTS tariff code lookup

Resolves a Harmonized Tariff Schedule (HS/HTS) code to its description, duty rates and place in the schedule, straight off USITC's own published data.

Also known as: hs code, hts code, tariff code, tariff classification, customs code, customs classification, harmonized code, harmonized system code, harmonized tariff schedule, duty rate, import duty

Call it

bowmark.tariff.lookup(code: string): Promise<TariffLookupResult>

Functions

Function	What it does
`lookup`	Looks up an HS/HTS code (e.g. "6109.10.00") and returns its description, Column 1 General/Special and Column 2 duty rates, plus any statistical-suffix breakouts nested under it.

Types

interface TariffEntry {
  htsno: string             // "6109.10.00" or a statistical-suffix row "6109.10.00.04"
  description: string
  indent: number             // nesting depth in HTS's own hierarchy
  generalRate: string        // Column 1 General (NTR) rate, e.g. "16.5%", "Free"
  specialRate: string        // Column 1 Special — preferential/FTA rates
  otherRate: string          // Column 2 — non-NTR countries
  units: string[]            // e.g. ["doz.", "kg"]
}

interface TariffLookupResult {
  code: string                // as passed, trimmed
  entry: TariffEntry | null   // exact htsno match, or null
  children: TariffEntry[]     // statistical-suffix rows nested under entry
  warnings: string[]
}

Examples

// A bare code — this is what a customs/import-classification workflow already has.
const { entry, children } = await bowmark.tariff.lookup("6109.10.00");
log(`${entry?.htsno}: ${entry?.description} — general ${entry?.generalRate}`);
return { entry, children };

Providers behind it

None — this capability needs no site. It computes the answer, or reads a public API that publishes it.