{"uid":"cap_DRIcnGVYBEntU7mRBCiU6","slug":"hts-classify-bulk-hs-hts10-tariff-code-classifier-8667d203","name":"HTS Classify — Bulk HS/HTS10 Tariff Code Classifier","description":"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","url":"https://hts-classify.x402supply.com/tools/classify_bulk?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f_6GiW-nlvLt53JW77bUv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"E-commerce import duty research","prompt":"I'm importing 5 new products from China and need to know their HTS10 codes and general duty rates — can you classify 'wireless Bluetooth earbuds', 'men's polyester jogger pants', 'tempered glass phone screen protector', 'silicone kitchen spatula', and 'stainless steel water bottle' and show me the top 3 candidates each?"},{"title":"Customs compliance check for a freight shipment","prompt":"We have a shipment coming in and need HTS classifications for 'women's knitted wool sweater' and 'LED grow light for indoor plants' — can you find the top 2 HTS10 candidates for each so we can hand them to our broker for review?"},{"title":"Product catalog tariff code enrichment","prompt":"I need to tag our product catalog with HTS codes — can you classify 'portable lithium-ion power bank 20000mAh' and 'cotton canvas tote bag' into their HTS10 tariff codes, including the duty rate and the full description path so I can see how each code fits?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:31:43.590Z","isFirstParty":false,"canonicalSlug":"hts-classify-bulk-hs-hts10-tariff-code-classifier-8667d203"}