import-duty-calculator
v1.0.0
Published
Estimate US import duty on a product from any origin. Returns the stacked 2026 duty rate and amount with sources and an as-of date. Keyless, no HTS lookup required.
Maintainers
Readme
Import Duty Calculator
Estimate US import duty on a product from any origin. Returns the stacked 2026 duty rate and amount with sources and an as-of date. Keyless, no HTS lookup required.
Import Duty Calculator is a simple import-duty estimate for any product and origin country. 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 import-duty-calculatorQuick start
const { calculateImportDuty } = require('import-duty-calculator');
const imp = await calculateImportDuty({ product: 'leather handbag', origin: 'CN', value: 800 });
console.log(imp);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
