{"uid":"cap_yl78ZtSC6Q_PaLCsODc1k","slug":"hts-code-search-candidate-tariff-classifications-by-product-description-c91f72d7","name":"HTS Code Search – Candidate Tariff Classifications by Product Description","description":"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.","url":"https://fittings.sh/v1/hts/search","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":["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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00598","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.00598/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00598","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00598","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9XMTVJzWCfSwTYheJLa-0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.00598","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns candidate HTS (Harmonized Tariff Schedule) codes for a plain-language product description, including code, description, units of quantity, and duty rates.","exampleAgentPrompt":"What are the HTS classification codes for 'stainless steel kitchen knives'? Give me the top 5 results with their codes, descriptions, and duty rates.","exampleUseCases":[{"title":"Customs Filing for Imported Goods","prompt":"I'm importing ceramic floor tiles from Italy and need to know the right HTS code to put on the customs declaration — can you search for the top matches and show me the duty rates?"},{"title":"E-commerce Tariff Compliance Check","prompt":"We're adding a new product line of lithium-ion battery packs for e-bikes to our import catalog. What HTS codes come up for 'lithium-ion battery packs' and what are the associated duty rates?"},{"title":"Trade Analyst Product Classification Research","prompt":"I need to find candidate HTS classifications for 'cotton woven men's dress shirts' — show me up to 10 results with their codes, descriptions, and units of quantity."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:09:53.718Z","isFirstParty":false}