⚙️

Total Landed Cost

ActiveCoreMUSTFREE

What it does

Get the full import cost for any product shipped internationally. Total Landed Cost includes the product price, shipping cost, import duties, taxes (VAT/GST), insurance, and brokerage fees. POTAL computes everything in a single API call with sub-50ms response time, using pre-computed tariff data for 240 countries.

Required Fields for 100% Accuracy

1 required / 9 total

Field	Type	Required	Description	Example
`price`	number	!	Product price	`999.00`
`origin`	string	opt	Origin country (ISO 2-letter code)Critical for duty rate + FTA lookup.	`CN`
`destinationCountry`	string	opt	Destination country (ISO 2-letter code, default: US)	`US`
`shippingPrice`	number	opt	Shipping cost (default: 0)	`25.00`
`shippingTerms`	string	opt	DDP (default), DDU, CIF, FOB, EXWDDP = buyer pays nothing extra at door. DDU = buyer pays duties on delivery.	`DDP`
`productName`	string	opt	Product name (auto-classifies if no hsCode)	`Laptop computer`
`hsCode`	string	opt	HS code (skips auto-classification)	`8471.30`
`weight_kg`	number	opt	Weight for shipping cost estimate	`2.5`
`quantity`	number	opt	Number of items	`1`

Tips for Best Accuracy

✓price + origin + destinationCountry = core trio for accurate landed cost
✓Adding shippingPrice gives true total; without it, shipping is estimated from weight
✓shippingTerms determines who pays duties — DDP at checkout vs DDU at delivery
✓hsCode speeds up response and avoids classification ambiguity

Common Mistakes

✗Omitting origin — without it, duty rate defaults to MFN and FTA savings are missed
✗Confusing DDP vs DDU — DDP means buyer pays total at checkout, DDU means surprise fees at delivery
✗Not including shippingPrice — landed cost without shipping is incomplete

How to use it

Prepare shipment details

Include product name/HS code, price, shipping cost, origin country, and destination country.

Choose shipping terms

Specify DDP (Delivered Duty Paid), DDU (Delivered Duty Unpaid), or other Incoterms like CIF/FOB/EXW.

Send the request

POST /api/v1/calculate returns the complete cost breakdown with every fee itemized.

Display to buyer

Show the total landed cost at checkout so buyers know exactly what they'll pay — no surprise fees.

API Reference

POST/api/v1/calculate

Request

{
  "productName": "Laptop computer",
  "price": 999,
  "shippingPrice": 25,
  "origin": "CN",
  "destinationCountry": "US",
  "shippingTerms": "DDP",
  "quantity": 1
}

Response

{
  "totalLandedCost": 1074,
  "breakdown": {
    "productCost": 999,
    "shippingCost": 25,
    "duty": 0,
    "tax": 0,
    "insurance": 1.5,
    "total": 1074
  },
  "tariffOptimization": {
    "optimalRateType": "ITA",
    "optimalAgreementName": "Information Technology Agreement",
    "savingsVsMfn": 49.95
  }
}

cURL

curl -X POST https://potal.app/api/v1/calculate \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"productName":"Laptop computer","price":999,"shippingPrice":25,"origin":"CN","destinationCountry":"US","shippingTerms":"DDP"}'

Related Features

⚙️Duty Rate Calculation

Look up MFN, MIN, and AGR duty rates for 240 countries

⚙️Tax Calculation (VAT/GST)

Calculate VAT, GST, and sales tax for 240 countries and territories

⚙️Currency Conversion

Real-time exchange rates with daily auto-updates for 160+ currencies

🚚DDP Quote

Compare DDP vs DDU costs with itemized fee breakdown

🚚Shipping Rates

Compare rates across 8 carriers including DHL, FedEx, UPS

Having issues?

🐛 Report a Bug ❓ Ask a Question 💡 Suggest Improvement