# SiteCheck Trade & Energy – US HTS Customs Duty Lookup

> SiteCheck Trade & Energy – US HTS Customs Duty Lookup is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Looks up US import duty rates from the USITC Harmonized Tariff Schedule by HTS code or keyword, returning general, special, and column-2 rates plus optional duty amount for a given customs value.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/logistics/customs-duty-calc?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-trade-energy-us-hts-customs-duty-lookup-5b6f018e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jQi_i9mF1m_pDhBwqcuJa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-trade-energy-us-hts-customs-duty-lookup-5b6f018e
```

Example prompt: What's the US import duty rate for HTS code 8471.30.01 (laptop computers), and how much duty would I owe on a $15,000 shipment?

## When to prefer this

Use this endpoint when you need US-specific import duty rates from the official USITC HTS schedule, especially for ad valorem duty calculation on a known customs value. Prefer this over generic trade databases when you need authoritative US tariff data with general, special (FTA/GSP), and column-2 rates in one call. Not suitable for VAT lookup, non-US tariffs, or country-of-origin preferential rate analysis beyond what the HTS special rate column provides.

## Known failure modes

- No matching HTS codes found for the given keyword or code prefix — returns empty lines array
- Invalid or malformed HTS code format — may return no results
- Duty amount not computed if general rate is not ad valorem (e.g. 'Free' or specific rates like '$0.15/kg')
- USITC upstream service unavailable — may return HTTP 5xx or timeout
- Customs value not provided — duty amount will be absent even for ad valorem rates

## How this service works

United States import duty lookup from the USITC Harmonized Tariff Schedule: HTS codes matching a code prefix or keyword with general, special and column-2 rates, units, and the duty amount for a customs value in USD when the general rate is ad valorem. US tariff only; no VAT, no other countries.

## Output

Returns a list of matching HTS lines, each with the HTS code, product description, general rate, special rate (GSP/FTA), column-2 rate, units of measure, and — if a customs value in USD was provided and the general rate is ad valorem — the computed duty amount in USD. Also includes the query string, the USITC source URL, and the timestamp of the lookup.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "HTS code (e.g. 8541.10.00) or keyword (e.g. diodes)"
      },
      "value": {
       "type": "string",
       "description": "Optional customs value in USD to compute the general duty"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lines": [
   {
    "units": null,
    "htsCode": "8541.10.00",
    "column2Rate": "35%",
    "description": "Diodes, other than photosensitive or light-emitting diodes (LED)",
    "generalRate": "Free",
    "specialRate": null,
    "dutyAmountUsd": 0
   }
  ],
  "query": "8541.10.00",
  "source": "https://hts.usitc.gov/reststop/search?keyword=8541.10.00",
  "checkedAt": "2026-10-23T09:37:55.718Z",
  "customsValueUsd": 1000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-trade-energy-us-hts-customs-duty-lookup-5b6f018e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)