# HS Tariff Code & Customs Duty Lookup

> HS Tariff Code & Customs Duty Lookup is a paid API for AI agents from api.boscolabs.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-13).

Look up US HTS or UK tariff codes, MFN/preferential duty rates, and UK VAT by HTS code or plain-language product description.

## Facts

- Endpoint: POST https://api.boscolabs.dev/v1/tariff-lookup?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hs-tariff-code-customs-duty-lookup-8714e9ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qm5rZZudh5RDIjdsIHkFD

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 hs-tariff-code-customs-duty-lookup-8714e9ec -d '<json body>'
```

Example prompt: What's the US import duty rate for bicycles (HTS code 8712.00.15) coming from China — including any preferential rates and Section 301 additional duties?

## When to prefer this

Use this endpoint when you need authoritative, source-linked tariff classification and duty rates from official government schedules (USITC for US, HMRC for UK), including MFN, preferential, and Column 2 rates, plus UK VAT. Prefer this over general trade databases when you need direct citation of official sources per row, pay-per-row pricing, or when you need to generate candidate HTS codes from a plain-language product description. Not suitable for binding classification rulings or legal advice.

## Known failure modes

- Invalid HTS code format returns an error (no charge)
- Empty result for unrecognized product description (no charge)
- Ambiguous product query may return low-confidence or mismatched candidate codes
- Origin country code not in ISO 3166 alpha-2 format causes validation error
- API returns warnings when Chapter 99 or supplemental duties (e.g. Section 301) apply but are not fully enumerated in the row

## How this service works

Data tools for AI agents and analysts: SEC filings, insider trades, company accounts, sanctions, EU law, tenders, contracts. Sourced JSON, pay per result.

## Output

A JSON array of tariff rows, each containing the HTS/tariff code, formatted code, description, general MFN duty rate, preferential rates (by trade agreement), Column 2 rate, additional duties (e.g. Section 301), UK VAT where applicable, code hierarchy, source URL, official edition/as-of date, and warnings about supplemental measures. Also returns total charge in USD, duration, and attribution to official source (USITC or HMRC).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "code": {
   "type": "string",
   "pattern": "^[\\d\\s.\\-]*$",
   "description": "A US HTS code"
  },
  "query": {
   "type": "string",
   "pattern": "^[^\\[\\]{}<>\\r\\n]*$",
   "description": "Plain product description, 2-200 characters, e.g. \"bicycle\" or \"cotton t-shirt\""
  },
  "market": {
   "enum": [
    "US",
    "UK",
    "GB"
   ],
   "type": "string",
   "default": "US",
   "description": "Which tariff to read: \"US\" (Harmonized Tariff Schedule, USITC) or \"UK\""
  },
  "originCountry": {
   "type": "string",
   "pattern": "^\\s*([A-Za-z]{2})?\\s*$",
   "description": "ISO 3166 alpha-2 code of the country the goods come from, e.g. \"CN\" or \"DE\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "vat": [],
    "code": "87120015",
    "as_of": "2026-11-06",
    "query": null,
    "units": [],
    "market": "US",
    "api_url": "https://hts.usitc.gov/reststop/exportList?from=8712&to=8712.99.99.99&format=JSON",
    "edition": "2026 HTS Revision 22",
    "warnings": [
     "Chapter 99 measures applied by note lists (Section 301 duties on goods of Chi..."
    ],
    "hierarchy": [
     {
      "code": "8712.00",
      "description": "Bicycles and other cycles (including delivery tricycles), not motorized:"
     }
    ],
    "rate_line": "8712.00.15",
    "declarable": null,
    "disclaimer": "Not a binding classification ruling. Reference data only, not legal advice; t...",
    "match_type": "code",
    "source_url": "https://hts.usitc.gov/search?query=8712.00.15",
    "attribution": "Source: Harmonized Tariff Schedule of the United States (HTS), U.S. Internati...",
    "description": "Bicycles having both wheels not exceeding 63.5 cm in diameter",
    "provided_by": "Bosco Labs (boscolabs.dev)",
    "general_rate": "11%",
    "retrieved_at": "2026-11-06T08:58:34+00:00",
    "column_2_rate": "30%",
    "candidate_rank": null,
    "code_formatted": "8712.00.15",
    "origin_country": null,
    "schema_version": "1",
    "duration_seconds": 0.76,
    "additional_duties": [],
    "preferential_rates": [
     {
      "rate": "Free",
      "applies_to": [
       "A+"
      ]
     }
    ],
    "special_rates_text": "Free (A+,AU,BH,CL,CO,D,E,IL,JO,KR,MA,OM,P,PA,PE,S,SG) 5.5% (JP)",
    "temporary_reductions": [
     {
      "rate": "Free",
      "reference": "9902.17.07",
      "description": "Bicycles each with no seat, no seat tube and no seat stay, designed to be ped..."
     }
    ],
    "preferential_rates_total": 2
   }
  ],
  "tool": "tariff-lookup",
  "count": 1,
  "message": "",
  "paid_via": "x402",
  "warnings": [],
  "balance_usd": 0,
  "charged_usd": 0.005,
  "duration_seconds": 1.2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hs-tariff-code-customs-duty-lookup-8714e9ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boscolabs.dev](https://www.zero.xyz/host/api.boscolabs.dev/llms.txt)
