# HTS Classify — Bulk HS/HTS10 Tariff Code Classifier

> HTS Classify — Bulk HS/HTS10 Tariff Code Classifier is a paid API for AI agents from hts-classify.x402supply.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-30).

Classifies one or more product descriptions into candidate HS/HTS10 tariff codes using BM25 retrieval over the USITC HTS schedule, returning full parent-chain descriptions, general duty rates, and confidence scores.

## Facts

- Endpoint: POST https://hts-classify.x402supply.com/tools/classify_bulk?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hts-classify-bulk-hs-hts10-tariff-code-classifier-8667d203
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DRIcnGVYBEntU7mRBCiU6

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-classify-bulk-hs-hts10-tariff-code-classifier-8667d203 -d '<json body>'
```

Example prompt: Can you classify these 3 products into their HTS10 tariff codes and tell me the general duty rate for each: 'men's cotton t-shirt, knitted', 'lithium-ion battery pack', and 'stainless steel kitchen knife'? Give me the top 2 candidates per item.

## When to prefer this

Use this endpoint when you need fast, deterministic HS/HTS10 classification without requiring an LLM to hallucinate codes — it retrieves directly from the official USITC HTS schedule using BM25. Prefer it for bulk classification of product lists (up to 100 items per call), when you need the duty rate alongside the code, or when you want an interpretable confidence score and reasoning. Not a substitute for a binding customs ruling, but ideal for research, catalog enrichment, and pre-broker verification.

## Known failure modes

- Empty or too-short product description produces low-confidence or irrelevant candidates
- Highly ambiguous descriptions may return candidates spanning multiple unrelated HS chapters
- Rate-limiting or payment failure returns HTTP 402 requiring x402 payment
- More than 100 items in a single request is rejected by schema validation
- Niche or highly technical products may not match well against the USITC schedule's natural language descriptions
- Origin hint may not materially change results if the schedule has no country-specific subheadings

## How this service works

Classify a product description into candidate HS/HTS10 tariff codes. Deterministic BM25 retrieval over the USITC HTS schedule with heading-agreement boosting, returning the full parent-chain description, general duty rate, and a score-gap confidence per candidate. Not a customs ruling — always inclu

## Output

Returns a results array with one entry per input product, each containing a ranked list of candidate HTS10 tariff codes. Each candidate includes: the 6-digit HS code, the 10-digit HTS code, a confidence score (0–1) derived from BM25 score gap, a short reasoning string explaining which terms were matched, the full hierarchical description path from the HTS schedule, and the general (MFN) duty rate. A legal disclaimer is always appended noting this is not a binding customs ruling.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "items": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 500,
    "minLength": 1
   },
   "maxItems": 100,
   "minItems": 1
  },
  "options": {
   "type": "object",
   "properties": {
    "top_k": {
     "type": "integer",
     "default": 3,
     "maximum": 10,
     "minimum": 1
    },
    "origin_hint": {
     "type": "string",
     "maxLength": 100
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "index": 0,
    "candidates": [
     {
      "hs6": "6109.10",
      "hts10": "6109.10.00.12",
      "confidence": 0.95,
      "duty_general": "",
      "reasoning_short": "Matched terms [cotton, t, shirt, knitted, men] against \"Men's (338)\" (HS6 6109.10).",
      "description_path": "T-shirts, singlets, tank tops and similar garments, knitted or crocheted: > Of cotton > Men's or boys': > Other T-shirts: > Men's (338)"
     }
    ]
   },
   {
    "index": 1,
    "candidates": [
     {
      "hs6": "8507.60",
      "hts10": "8507.60.00.90",
      "confidence": 0.95,
      "duty_general": "",
      "reasoning_short": "Matched terms [lithium, ion, battery] against \"Other\" (HS6 8507.60).",
      "description_path": "Electric storage batteries, including separators therefor, whether or not rectangular (including square); parts thereof: > Lithium-ion batteries > Other: > Other"
     }
    ]
   }
  ],
  "disclaimer": "Informational classification aid — not a customs ruling. Verify with a licensed customs broker for binding classification."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hts-classify-bulk-hs-hts10-tariff-code-classifier-8667d203/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hts-classify.x402supply.com](https://www.zero.xyz/host/hts-classify.x402supply.com/llms.txt)