Developer Docs

LandedFees API

Five stable v1 endpoints for landed-cost calculation, HS classification, and multi-origin comparison. Same engine that resolves rates against USITC HTS, EU TARIC, HMRC, and CBP FX for the LandedFees UI. Bearer-key auth. JSON in, JSON out.

What you get

Full landed-cost stack: MFN, Section 232 / 301 / 122 / 338, AD/CVD, VAT, GST, MPF, HMF, de-minimis.
Verified rate coverage for 220+ destinations. Never estimates.
HS classification with confidence scores and reason strings.
Multi-origin comparison (up to 6 origins in parallel) for reshoring analysis.
Direct lookup: duty and tax rates by country + HS code.
Compliance flags for PGA, restricted products, denied parties, unit-price deviation.

Endpoints

POST/v1/calcLanded cost for one shipment.POST/v1/calc/bulkUp to 500 rows in one call.POST/v1/classifyHS / HTS code from a product description.POST/v1/compareSide-by-side across up to 6 origins.GET/v1/rates/{country}/{hs}Duty and tax rate lookup.

Base URL and versioning

Production requests hit https://www.landedfees.com/api/v1. The OpenAPI 3.1 spec lives at /api/openapi.yaml. Breaking changes ship under a new major version prefix. Additive changes land under v1 with 30-day changelog notice.

SDKs

TypeScript / JavaScript: pnpm add @landedfees/sdk
Python: pip install landedfees

Full API docs

The complete reference (concepts, guides, per-endpoint pages, SDK docs) lives on the Mintlify-hosted site:

docs.landedfees.com →

Quickstart

curl https://www.landedfees.com/api/v1/calc \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "destination_country": "US",
    "origin_country": "CN",
    "incoterm": "FOB",
    "transport_mode": "ocean",
    "currency": "USD",
    "line_items": [{
      "description": "Wireless earbuds",
      "hs_code": "8517.62.00",
      "quantity": 500,
      "unit_value": 12.50,
      "origin_country": "CN"
    }]
  }'