Skip to main content

​
What LandedFees is

LandedFees resolves the true cost of importing a shipment: the goods value, freight, insurance, every duty layer (MFN, Section 232, 301, 122, 338, AD/CVD, FTA preferences), destination-country VAT or GST, and the mandatory customs fees (MPF, HMF, ISF, broker, exam expected value). Every rate is anchored to a primary source (USITC HTS, EU TARIC, HMRC UK Trade Tariff, WCO HS, CBP weekly FX per 19 CFR 141.62). No estimates.

​
Who this API is for

Developers at import-of-record firms, freight forwarders, brokerage teams, and procurement automation vendors who need programmatic landed-cost math inside quoting flows, ERP integrations, and CI pipelines. Typical use cases:
  • Real-time landed-cost quoting inside a checkout or ERP.
  • Nightly re-audit of the last N shipments after a tariff-notice publication.
  • Multi-origin sourcing analysis for reshoring decisions.
  • HS classification triage on new SKU intake.

​
The CostLayer output model

Every /v1/calc response returns a breakdown array of CostLayer objects. Each layer carries its own code, amount, rate, exempted flag, and an optional note. This is the shape:
Layers stack. A single shipment can carry MFN, Section 232, Section 301, Section 122, AD/CVD, MPF, and HMF at the same time. Because the API returns each layer as a discrete row, downstream systems can log, audit, or dispute any single line without re-running math.

​
Primary-source citations

Every rate resolves against a live table. Every compliance flag ships with source, source_url, and legal_citation fields so your team can trace a number to a statute, a Federal Register notice, or a TARIC line. If a rate cannot be resolved (rare, non-US non-EU tail), the API returns a data_gap compliance flag rather than a fabricated number.

​
Five stable v1 endpoints

  • POST /v1/calc: landed cost for one shipment.
  • POST /v1/calc/bulk: up to 500 rows per call.
  • POST /v1/classify: HS or HTS code from a product description.
  • POST /v1/compare: up to 6 origin countries side-by-side.
  • GET /v1/rates/{country}/{hs}: MFN plus overlay plus VAT lookup.
Additive changes ship under v1 with 30-day changelog notice. Breaking changes ship under a new major version prefix.