US Customs Duty

Get current US customs duty for an import: total stacked duty rate, dollar amount and source links. Covers MFN, Section 301/232, MPF and HMF. Keyless, source-backed 2026 rates.

US Customs Duty is authoritative US customs duty figures with official source links. It runs on the maintained, source-backed GroundTruth data layer, so numbers reflect current 2026 stacked tariffs (MFN + Section 301/232 where applicable), MPF/HMF and full landed cost—no HTS code required.

Install

npm install us-customs-duty

Quick start

const { getCustomsDuty } = require('us-customs-duty');

const duty = await getCustomsDuty({ product: 'cotton t-shirt', origin: 'VN', value: 500 });
console.log(duty);

Parameters

| Name | Type | Description | |---|---|---| | product | string | Plain-language product description. | | origin | string | Origin country code: CN, VN, IN, MX (or default). | | value | number | Declared value. | | mode | string | ocean (default) or air. | | freight | number | Optional freight, for a complete landed cost. | | brokerFee | number | Optional broker fee. |

What you get back

A source-backed result containing the stacked duty rate, duty amount, MPF/HMF, total landed cost, an as_of date and the official source URLs.

Free vs Enterprise

The public endpoint is keyless and rate-limited—perfect for evaluation and light use. For unlimited calls, done-for-you setup and rate-change alerts, see GroundTruth Enterprise:

https://dytsk9wrfv.page.coze.site/groundtruth.html

License

MIT