{ "info": { "name": "US Tariff Rates API", "description": "Real-time US tariff rates, HTS code lookup, duty calculations, and AI-powered HTS classification.\n\n**Setup:**\n1. Set the `API_KEY` collection variable to your key from https://ustariffrates.com/pricing\n2. All requests include `X-API-Key: {{API_KEY}}` automatically\n\n**Free:** 25/mo | **Pro $49/mo:** 1,000 | **Team $199/mo:** 10,000 + metered overage | **Enterprise:** Unlimited\n\nDocs: https://ustariffrates.com/dev", "_postman_id": "us-tariff-rates-api-v1", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "base_url", "value": "https://ustariffrates.com/api", "type": "string" }, { "key": "API_KEY", "value": "your_api_key_here", "type": "string" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key", "type": "string" }, { "key": "value", "value": "{{API_KEY}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "item": [ { "name": "HTS Codes", "description": "Search and retrieve HTS tariff schedule data", "item": [ { "name": "Search HTS Codes", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/hts/search?q=laptops+portable+computers&chapter=84&page=1&per_page=20", "host": ["{{base_url}}"], "path": ["hts", "search"], "query": [ { "key": "q", "value": "laptops portable computers", "description": "Search query — product description or keyword" }, { "key": "chapter", "value": "84", "description": "Filter by HTS chapter (01–99)", "disabled": true }, { "key": "page", "value": "1" }, { "key": "per_page", "value": "20" } ] }, "description": "Full-text search across 35,571 HTS code descriptions." }, "response": [ { "name": "200 OK — Search Results", "status": "OK", "code": 200, "body": "{\n \"results\": [\n {\n \"hts_code\": \"8471.30.01\",\n \"description\": \"Portable automatic data processing machines\",\n \"chapter\": 84,\n \"heading\": \"8471\",\n \"subheading\": \"8471.30\",\n \"unit\": \"No.\"\n }\n ],\n \"total\": 42,\n \"page\": 1,\n \"per_page\": 20\n}" } ] }, { "name": "Get Tariff Details by HTS Code", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/hts/8471.30.01", "host": ["{{base_url}}"], "path": ["hts", "8471.30.01"] }, "description": "Returns complete tariff information including MFN rate, Section 301/232 overlays, AD/CVD orders, and FTA rates." }, "response": [ { "name": "200 OK — Tariff Details", "status": "OK", "code": 200, "body": "{\n \"hts_code\": \"8471.30.01\",\n \"description\": \"Portable automatic data processing machines\",\n \"mfn_rate\": \"Free\",\n \"column2_rate\": \"35%\",\n \"section_301\": {\n \"applies\": true,\n \"rate\": \"25%\",\n \"list\": \"List 3\"\n },\n \"section_232\": {\n \"applies\": false,\n \"rate\": null\n },\n \"antidumping\": [],\n \"cvd\": [],\n \"fta_rates\": {\n \"USMCA\": \"Free\",\n \"CAFTA-DR\": \"Free\",\n \"Korea\": \"Free\"\n },\n \"effective_date\": \"2025-01-01\",\n \"last_updated\": \"2025-03-01T00:00:00Z\"\n}" } ] } ] }, { "name": "Duty Calculator", "description": "Calculate duties, fees, and total landed costs", "item": [ { "name": "Calculate Duty — China Import", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"hts_code\": \"8471.30.01\",\n \"country_of_origin\": \"CN\",\n \"customs_value_usd\": 50000,\n \"freight_usd\": 2000,\n \"insurance_usd\": 150,\n \"shipment_mode\": \"ocean\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/duty/calculate", "host": ["{{base_url}}"], "path": ["duty", "calculate"] }, "description": "Calculate total landed cost for a Chinese import shipment. Section 301 rates applied automatically." }, "response": [ { "name": "200 OK — Duty Calculation", "status": "OK", "code": 200, "body": "{\n \"hts_code\": \"8471.30.01\",\n \"country_of_origin\": \"CN\",\n \"customs_value_usd\": 50000,\n \"mfn_duty\": 0,\n \"section_301_duty\": 12500,\n \"section_232_duty\": 0,\n \"ad_cvd_duty\": 0,\n \"total_duty\": 12500,\n \"effective_rate\": \"25%\",\n \"mpf\": 485,\n \"hmf\": 62.50,\n \"total_landed_cost\": 63047.50,\n \"breakdown\": {\n \"customs_value\": 50000,\n \"freight\": 2000,\n \"insurance\": 150,\n \"mfn_duty\": 0,\n \"section_301_duty\": 12500,\n \"mpf\": 485,\n \"hmf\": 62.50\n }\n}" } ] }, { "name": "Calculate Duty — USMCA (Mexico)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"hts_code\": \"8471.30.01\",\n \"country_of_origin\": \"MX\",\n \"customs_value_usd\": 50000,\n \"shipment_mode\": \"truck\",\n \"fta\": \"USMCA\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/duty/calculate", "host": ["{{base_url}}"], "path": ["duty", "calculate"] }, "description": "Calculate with USMCA preferential rate applied." } } ] }, { "name": "AI Classification", "description": "AI-powered HTS code classification from product descriptions", "item": [ { "name": "Classify Product", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"Stainless steel water bottle, 32oz, vacuum insulated double wall, BPA-free, with screw-top lid\",\n \"country_of_origin\": \"CN\",\n \"include_duty\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/classify", "host": ["{{base_url}}"], "path": ["classify"] }, "description": "AI classifies your product into the correct HTS code. Returns top match with confidence score and alternatives." }, "response": [ { "name": "200 OK — Classification Result", "status": "OK", "code": 200, "body": "{\n \"hts_code\": \"7323.93.00\",\n \"confidence\": 0.91,\n \"description\": \"Table, kitchen or other household articles of stainless steel\",\n \"alternatives\": [\n {\n \"hts_code\": \"9617.00.00\",\n \"confidence\": 0.07,\n \"description\": \"Vacuum flasks and other vacuum vessels\"\n }\n ],\n \"reasoning\": \"The product is a stainless steel household article (water bottle). Primary classification is 7323.93.00 for stainless steel household articles. Alternative 9617.00.00 for vacuum vessels has lower confidence as the product emphasizes the steel construction over insulation function.\",\n \"mfn_rate\": \"2%\",\n \"section_301_rate\": \"25%\"\n}" } ] }, { "name": "Classify Product — Electronics", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"USB-C charging cable, 6ft braided nylon, 100W PD fast charging, compatible with laptops and phones\",\n \"country_of_origin\": \"CN\",\n \"include_duty\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/classify", "host": ["{{base_url}}"], "path": ["classify"] } } } ] } ] }