Calculate landed cost and import duty
landed_costRead-onlyIdempotent
Calculate US import duty and landed cost estimates. Give hts_code when you know it and this returns the calculated base duty and trade actions (Section 301, Section 232, Section 338, AD/CVD and others), estimated duty, fees and import cost. When estimate_status is partial, AD/CVD is undetermined and the amounts are provisional; convey that the estimate is incomplete. Give product instead and it returns candidate HTS codes WITHOUT pricing, because the classification decides the duty and guessing it produces confidently wrong numbers: confirm the right code with the user, then call again with hts_code. The candidate step is not charged.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| product | No | Plain description, e.g. "outdoor metal furniture". Returns candidate codes to confirm, does not price. Provide this OR hts_code. | |
| hts_code | No | Exact HTS rate line, 8 or 10 digits, e.g. "9403.20.00.50". Takes precedence over product. 4 and 6 digit headings cannot be priced. | |
| country_code | Yes | ISO 2-letter country of ORIGIN (where the goods were made), e.g. "CN", "CA", "VN". | |
| shipment_mode | No | Optional: "ocean" (default) or "air". Affects government fees only. | |
| declared_value | Yes | Customs value of the shipment in USD. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| source | No | ||
| country | No | Country of origin, as resolved. | |
| gateway | No | Guest tier only. | |
| message | No | ||
| hts_code | No | The HTS line the duty was calculated on. | |
| warnings | No | ||
| candidates | No | Candidate HTS lines to confirm, present only when needs_classification is true. | |
| disclaimer | No | Planning estimate, not a customs ruling. Pass this on to the user. | |
| description | No | Official description of that line. | |
| service_fees | No | Filing and handling charges such as ISF. Not government fees; CBP charges nothing to receive an Importer Security Filing. | |
| adcvd_supplier | No | Supplier deposit evidence when supplied by the calculation: reviewed entry date, matched legal identities, rules, effective windows, official sources, and cases actually included. A matched case does not establish complete all-orders coverage. | |
| declared_value | No | Customs value used, in USD. | |
| duty_breakdown | No | Every trade action considered, keyed by authority (base_duty, section_301, section_232, section_338_canada and the rest). Each carries rate, applies, and often a reason and legal reference. An action with applies false and upcoming true is scheduled but not yet owed. | |
| policy_notices | No | Source-backed scope and supplier notices affecting use of this estimate. | |
| total_duty_usd | No | Calculated duty estimate in USD. When estimate_status.status is partial, this is provisional and is not the complete payable duty. | |
| estimate_status | No | A partial status means AD/CVD is undetermined and this estimate is incomplete. Pass its message to the user; a zero calculated AD/CVD component does not establish zero liability. | |
| government_fees | No | MPF and HMF, the fees CBP actually collects. | |
| total_duty_rate_pct | No | Calculated duty estimate as a percentage of declared value. Read estimate_status before describing this as a complete estimate. | |
| needs_classification | No | True when a product description was given instead of a code. Nothing was priced and nothing was charged; show the candidates and ask the user to confirm. | |
| total_import_cost_usd | No | Calculated duties plus government and service fees, excluding merchandise and freight. Provisional when estimate_status is partial. | |
| guest_lookups_remaining | No | Guest tier only. |