{"uid":"cap_qm5rZZudh5RDIjdsIHkFD","slug":"hs-tariff-code-customs-duty-lookup-8714e9ec","name":"HS Tariff Code & Customs Duty Lookup","description":"Data tools for AI agents and analysts: SEC filings, insider trades, company accounts, sanctions, EU law, tenders, contracts. Sourced JSON, pay per result.","url":"https://api.boscolabs.dev/v1/tariff-lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"code":{"type":"string","pattern":"^[\\d\\s.\\-]*$","description":"A US HTS code"},"query":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$","description":"Plain product description, 2-200 characters, e.g. \"bicycle\" or \"cotton t-shirt\""},"market":{"enum":["US","UK","GB"],"type":"string","default":"US","description":"Which tariff to read: \"US\" (Harmonized Tariff Schedule, USITC) or \"UK\""},"originCountry":{"type":"string","pattern":"^\\s*([A-Za-z]{2})?\\s*$","description":"ISO 3166 alpha-2 code of the country the goods come from, e.g. \"CN\" or \"DE\""}}},"responseSchema":{"type":"json","example":{"rows":[{"vat":[],"code":"87120015","as_of":"2026-11-06","query":null,"units":[],"market":"US","api_url":"https://hts.usitc.gov/reststop/exportList?from=8712&to=8712.99.99.99&format=JSON","edition":"2026 HTS Revision 22","warnings":["Chapter 99 measures applied by note lists (Section 301 duties on goods of Chi..."],"hierarchy":[{"code":"8712.00","description":"Bicycles and other cycles (including delivery tricycles), not motorized:"}],"rate_line":"8712.00.15","declarable":null,"disclaimer":"Not a binding classification ruling. Reference data only, not legal advice; t...","match_type":"code","source_url":"https://hts.usitc.gov/search?query=8712.00.15","attribution":"Source: Harmonized Tariff Schedule of the United States (HTS), U.S. Internati...","description":"Bicycles having both wheels not exceeding 63.5 cm in diameter","provided_by":"Bosco Labs (boscolabs.dev)","general_rate":"11%","retrieved_at":"2026-11-06T08:58:34+00:00","column_2_rate":"30%","candidate_rank":null,"code_formatted":"8712.00.15","origin_country":null,"schema_version":"1","duration_seconds":0.76,"additional_duties":[],"preferential_rates":[{"rate":"Free","applies_to":["A+"]}],"special_rates_text":"Free (A+,AU,BH,CL,CO,D,E,IL,JO,KR,MA,OM,P,PA,PE,S,SG) 5.5% (JP)","temporary_reductions":[{"rate":"Free","reference":"9902.17.07","description":"Bicycles each with no seat, no seat tube and no seat stay, designed to be ped..."}],"preferential_rates_total":2}],"tool":"tariff-lookup","count":1,"message":"","paid_via":"x402","warnings":[],"balance_usd":0,"charged_usd":0.005,"duration_seconds":1.2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gWNFU0086YNxOhigjYEec","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up US HTS or UK tariff codes, MFN/preferential duty rates, and UK VAT by HTS code or plain-language product description.","exampleAgentPrompt":"What's the US import duty rate for bicycles (HTS code 8712.00.15) coming from China — including any preferential rates and Section 301 additional duties?","exampleUseCases":[{"title":"Import duty check for new product line","prompt":"We're sourcing stainless steel cookware from China — can you look up the US tariff rate for that product, including any Section 301 duties and preferential rates that might apply?"},{"title":"UK customs classification for e-commerce","prompt":"I need to list the UK tariff code and import VAT rate for cotton t-shirts I'm shipping from India to the UK — can you find the right code and all applicable duties?"},{"title":"Candidate HTS codes for trade compliance filing","prompt":"I'm importing a product described as 'lithium-ion battery packs for electric bicycles' and I'm not sure of the HTS code — can you give me the top 5 candidate US HTS codes for this?"}],"resultDescription":"A JSON array of tariff rows, each containing the HTS/tariff code, formatted code, description, general MFN duty rate, preferential rates (by trade agreement), Column 2 rate, additional duties (e.g. Section 301), UK VAT where applicable, code hierarchy, source URL, official edition/as-of date, and warnings about supplemental measures. Also returns total charge in USD, duration, and attribution to official source (USITC or HMRC).","failureModes":["Invalid HTS code format returns an error (no charge)","Empty result for unrecognized product description (no charge)","Ambiguous product query may return low-confidence or mismatched candidate codes","Origin country code not in ISO 3166 alpha-2 format causes validation error","API returns warnings when Chapter 99 or supplemental duties (e.g. Section 301) apply but are not fully enumerated in the row"],"whenToPreferThis":"Use this endpoint when you need authoritative, source-linked tariff classification and duty rates from official government schedules (USITC for US, HMRC for UK), including MFN, preferential, and Column 2 rates, plus UK VAT. Prefer this over general trade databases when you need direct citation of official sources per row, pay-per-row pricing, or when you need to generate candidate HTS codes from a plain-language product description. Not suitable for binding classification rulings or legal advice.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T12:46:54.895Z","isFirstParty":false,"canonicalSlug":"hs-tariff-code-customs-duty-lookup-8714e9ec"}