Skip to main content
Developer API

Landed Cost API — Integrate Duty Calculation into Any Platform

The Zentria Flow REST API classifies products to HS codes and calculates full landed cost — duty, VAT, MPF, and freight — for 190+ countries in real time. Embed accurate import costs into your checkout, TMS, or ERP.

May 2026·5 min read

Use Cases

E-commerce checkout duty calculation

Display accurate import duties and taxes at checkout for international customers. Reduce cart abandonment and prevent surprise charges on delivery.

ERP / procurement integration

Integrate landed cost into purchase orders and supplier quotes in real time. Finance teams get accurate total cost of ownership before PO approval.

Freight forwarder quoting platforms

Embed HS classification and duty calculation into your TMS or freight quoting tool. Deliver compliance-verified landed cost quotes to customers.

API Endpoints

POST
/v1/landed-cost

Calculate full landed cost: duty + VAT + freight + insurance for any product/origin/destination combination.

POST
/v1/classify

Classify a product description to HS code using AI. Returns 6-digit HS and 10-digit HTS with confidence score.

GET
/v1/tariff-rate

Look up current tariff rate for a specific HTS code, origin country, and destination country.

GET
/v1/ad-cvd

Check if an HTS code + origin country combination has active anti-dumping or countervailing duty orders.

POST
/v1/batch/classify

Classify up to 1,000 product lines in a single request. Returns HS codes, confidence scores, and duty rates.

Sample Request & Response

Request

POST /v1/landed-cost
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "product": "Stainless steel water bottle, 500ml",
  "origin_country": "CN",
  "destination_country": "US",
  "quantity": 500,
  "unit_price_usd": 4.50,
  "incoterms": "FOB",
  "freight_usd": 1200
}

Response

{
  "hs_code": "732519",
  "hts_code": "7325190000",
  "product_description": "Stainless steel articles, NEC",
  "duty_rate": 0.033,
  "section_301_rate": 0.25,
  "total_tariff_rate": 0.283,
  "customs_value_usd": 2250.00,
  "duty_usd": 637.35,
  "mpf_usd": 29.04,
  "hmf_usd": 2.68,
  "total_landed_cost_usd": 3119.07,
  "cost_per_unit_usd": 6.24,
  "confidence": 0.94
}

Frequently Asked Questions

What does the Zentria Flow Landed Cost API return?

The API returns: HS code classification with confidence score, applicable duty rate (MFN + Section 301 + Section 232 + AD/CVD where applicable), customs value, total duty amount, MPF (merchandise processing fee), HMF (harbor maintenance fee), VAT/GST for the destination country, and the final landed cost per unit and in total.

How accurate is the HS code classification?

The AI classifier achieves 94%+ accuracy on the first attempt for clearly described products. For complex or highly regulated products (chemicals, electronics, dual-use goods), confidence scores below 0.85 are flagged for manual review. The API returns a confidence score with every classification result.

Which countries does the Landed Cost API cover?

The API covers 190+ destination countries and 180+ origin countries — effectively the full WTO member set. Tariff data is updated in real time when USTR, CBP, or foreign customs authorities announce rate changes. Section 301, Section 232 and forced-labor tariff changes are reflected within hours of publication in the Federal Register.

Can I use the API for Shopify or WooCommerce?

Yes. Zentria Flow has native Shopify and WooCommerce plugins that connect your store to the API without custom coding. For custom integrations, the REST API accepts product title, description, HS code (if known), and origin/destination — and returns duty rates and landed costs that can be displayed at checkout or in the cart.

What is the API rate limit and pricing?

The API is available on a pay-per-use and subscription basis. The free tier includes 100 classifications per month. Paid plans start at $49/month for up to 5,000 API calls. Enterprise plans with dedicated support, higher throughput, and SLA guarantees are available for logistics platforms and large retailers.

Related Resources

Get Your API Key

Start with 100 free classifications per month. No credit card required.

Zentria Flow

Integrate landed cost data via API

100 free API calls/month — no card required. Production-ready with HS code lookup, duty rates, Section 301 (China lists and forced-labor), Section 232, VAT, and de minimis checks.

Zentria Brain