{"uid":"cap_TrLkvIvlndjSgtPb6WO4w","slug":"oneshot-agent-api-product-duty-rate-lookup-ea60f3b6","name":"OneShot Agent API – Product Duty Rate Lookup","description":"Look up the scheduled duty rate for a US tariff heading, or search the tariff schedule by keyword.","url":"https://win.oneshotagent.com/v1/tools/lookup/product-duty-rate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","description":"Most lines to return, in schedule order. From 1 to 50. Defaults to `20`."},"query":{"type":"string","description":"A tariff heading such as 7408.11, or a keyword such as copper wire. Several words match any of them; wrap them in double quotes for the exact phrase. 2 to 80 characters."}}},"responseSchema":{"type":"json","example":{"lines":[{"code":"7408.11","units":[],"indent":2,"footnotes":[],"other_rate":null,"description":"Of which the maximum cross-sectional dimension exceeds 6 mm:","general_rate":null,"special_rate":null,"additional_duties":null},{"code":"7408.11.30.00","units":["kg"],"indent":3,"footnotes":[],"other_rate":"7%","description":"With a maximum cross-sectional dimension over 9.5 mm","general_rate":"1%","special_rate":"Free (A,AU,BH,CL,CO,D,E,IL,JO,KR,MA,OM,P,PA,PE,S,SG)","additional_duties":null}],"total":3}},"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_4EvJme3vjZcpma91wHBW8","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":"Looks up US import tariff schedule lines for a given HTS code or keyword, returning duty rates, special rates, and schedule details","exampleAgentPrompt":"What's the US import duty rate for copper wire — look up HTS code 7408.11 and show me the general rate, any special trade agreement rates, and the top 10 schedule lines.","exampleUseCases":[{"title":"Import cost estimation for sourcing","prompt":"I'm planning to import aluminum sheet from South Korea — can you look up the duty rate for HTS code 7606.11 and tell me if South Korea gets a special rate?"},{"title":"Trade compliance check for product listing","prompt":"We're listing a new product category — wireless Bluetooth headphones. Can you search the tariff schedule for 'bluetooth headphones' and show me the general and special duty rates that would apply?"},{"title":"Tariff research for customs filing","prompt":"I need to file customs paperwork for a shipment — can you pull up all the schedule lines for HTS heading 8471.30 and show me the duty rates and any footnotes?"}],"resultDescription":"Returns an array of tariff schedule lines, each with the HTS code, description, indent level, units of measure, general duty rate, special rate (broken down by trade agreement country codes), other rate, additional duties, and footnotes. Also includes a total count of matching lines.","failureModes":["No matching HTS codes or keywords found — returns empty lines array","Ambiguous keyword matches too many or too few schedule entries","Payment of 0.005 USDC via x402 fails — request rejected before lookup","Malformed HTS code format returns no results","Rate limit or service unavailability returns error response"],"whenToPreferThis":"Use this endpoint when you need programmatic, per-call access to US HTS tariff schedule data without an API key subscription — especially for AI agent workflows that need duty rate lookups on demand. Ideal when you need to check specific HTS codes or search by product keyword and want both general and trade-agreement-specific (special) rates in a structured JSON response. Pay only $0.005 USDC per call via x402 with no upfront commitment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:38:34.227Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-product-duty-rate-lookup-ea60f3b6"}