{"uid":"cap_43a0OxMPc3Yhd3MpO5YgH","slug":"hts-hs-customs-code-classifier-ef4b1504","name":"HTS/HS Customs Code Classifier","description":"Classify any product to its HS / HTS customs code from a plain-English description. Expert LLM classification grounded in the live official USITC Harmonized Tariff Schedule: returns the 10-digit HTS code, international HS6, official description path, US duty rate (general + special programs), confidence, reasoning and alternates. JSON response. $0.04 USDC per call, pay via x402, no API key.","url":"https://toolsmith-api.dassad10.workers.dev/t/hs/classify","method":"GET","headers":{},"bodySchema":{"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":["desc"],"properties":{"desc":{"type":"string","description":"Plain-English product description, max 500 chars"},"dest":{"type":"string","description":"Destination country ISO code, default US (duty shown is US MFN)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"hs6":"9617.00","duty":{"usGeneral":"7.2%"},"htsCode":"9617.00.10.00","reasoning":"Vacuum vessel with steel body...","alternates":[{"hts":"7323.93.00","note":"if not vacuum-insulated"}],"confidence":0.85}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iWnhhCCYmRLoAUGPf4vHV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies a product from a plain-English description to its 10-digit HTS code and 6-digit HS code, with US duty rates, confidence score, and alternate codes.","exampleAgentPrompt":"What is the 10-digit HTS code and US import duty rate for 'men's leather dress shoes with rubber soles, not waterproof'? I need the confidence score and any alternate classifications too.","exampleUseCases":null,"resultDescription":"A JSON object containing the 10-digit HTS code, 6-digit international HS code, official USITC description path, US MFN general duty rate, applicable special program duty rates (e.g. GSP, USMCA), a confidence score (0-1), LLM reasoning for the classification, and a list of alternate HTS codes with their descriptions.","failureModes":["Ambiguous product description leads to low-confidence classification with multiple alternates","Description exceeds 500 characters — request rejected","Invalid destination country ISO code returns an error","Product is too novel or niche for the LLM to classify reliably","Payment via x402 fails, blocking the request","Rate limit or worker timeout on the Cloudflare edge"],"whenToPreferThis":"Use this endpoint when you need fast, LLM-grounded HTS/HS classification from a plain-English product description, especially when you also need the US duty rate and special trade program rates in a single call without maintaining a tariff database. Prefer this over manual USITC lookups or generic text search when you want structured JSON with confidence scoring and reasoning.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:29.320Z","isFirstParty":false}