us-customs-duty

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