# HTS Code Search – Candidate Tariff Classifications by Product Description

> HTS Code Search – Candidate Tariff Classifications by Product Description is a paid API for AI agents from fittings.sh, paid per call via x402, $0.00598/call, status unknown (last checked 2026-09-14).

Returns candidate HTS (Harmonized Tariff Schedule) codes for a plain-language product description, including code, description, units of quantity, and duty rates.

## Facts

- Endpoint: GET https://fittings.sh/v1/hts/search
- Price: $0.00598/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hts-code-search-candidate-tariff-classifications-by-product-description-c91f72d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yl78ZtSC6Q_PaLCsODc1k

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 hts-code-search-candidate-tariff-classifications-by-product-description-c91f72d7
```

Example prompt: What are the HTS classification codes for 'stainless steel kitchen knives'? Give me the top 5 results with their codes, descriptions, and duty rates.

## When to prefer this

Use this endpoint when you need to discover candidate HTS codes from a plain-language product description or partial code, especially for US customs classification and import duty research. Prefer this over manual tariff schedule browsing when automating compliance workflows, populating customs declarations, or building trade tools. If you already have a specific HTS code and need its full detail, use the companion v1/hts/lookup endpoint instead.

## Known failure modes

- Query too short (under 2 characters) returns a validation error
- Query over 100 characters may be rejected or truncated
- No matching HTS codes found returns an empty results list
- Ambiguous query may return many loosely-related codes requiring further filtering
- Statistical lines in results show no duty rate — parent lookup required for rate resolution
- Rate limiting or payment failure may return 402 or 429 responses

## How this service works

Candidate HTS classifications for a plain-language product description, each with its code, description, units of quantity and duty rates where the line carries them. A statistical line shows no rate of its own because it inherits its parent’s, which v1/hts/lookup resolves.

## Output

A list of up to 50 candidate HTS classification entries, each containing the 10-digit HTS code, a human-readable tariff description, units of quantity (e.g., 'No.', 'kg'), and duty rates where applicable. Statistical lines (which inherit rates from their parent chapter) are flagged and their rates can be resolved via a companion lookup endpoint.

## 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": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "number",
       "description": "Maximum results, 1-50, default 20"
      },
      "query": {
       "type": "string",
       "description": "Product description or partial code, 2-100 characters"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hts-code-search-candidate-tariff-classifications-by-product-description-c91f72d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)