⚙️

Duty Rate Calculation

ActiveCoreMUSTFREE

What it does

Look up MFN (Most Favored Nation), MIN (minimum), and AGR (agreement/preferential) duty rates for any HS code across 240 countries. POTAL uses pre-computed tariff data from official government sources including WTO, WCO, TARIC (EU), USITC (US), and more. Results are returned in under 50ms with no AI calls required.

Required Fields for 100% Accuracy

1 required / 12 total

Field	Type	Required	Description	Example
`price`	number	!	Product price (numeric value)Must be a valid non-negative number. Currency strings also accepted.	`25.00`
`origin`	string	opt	Origin country (ISO 2-letter code)Use ISO codes. Platform names like "AliExpress" also work.	`CN`
`destinationCountry`	string	opt	Destination country (ISO 2-letter code, default: US)	`US`
`hsCode`	string	opt	HS code (2-10 digits). Auto-classified from productName if not provided.	`6109.10`
`productName`	string	opt	Product name for auto-classification when hsCode is not provided	`Cotton t-shirt`
`shippingPrice`	number	opt	Shipping cost (default: 0)	`12.50`
`shippingTerms`	string	opt	Incoterms: DDP, DDU, CIF, FOB, EXW (default: DDP)	`DDP`
`weight_kg`	number	opt	Weight in kilograms for shipping estimate	`0.5`
`quantity`	number	opt	Item quantity	`10`
`firmName`	string	opt	Exporter firm name for anti-dumping/CVD rate matching	`Shenzhen Electronics Co`
`zipcode`	string	opt	US ZIP code for state/local sales tax	`90210`
`buyer_vat_number`	string	opt	Buyer VAT number for EU B2B reverse-charge	`DE123456789`

Tips for Best Accuracy

✓price is the only required field — everything else improves accuracy
✓Providing origin + destinationCountry enables FTA preferential rate lookup
✓Adding hsCode skips auto-classification and gives exact duty rates
✓firmName enables company-specific anti-dumping rates instead of "all others" rate
✓zipcode is essential for US destinations — state/local tax varies dramatically

Common Mistakes

✗Omitting origin country — without it, FTA savings cannot be calculated
✗Using full country names instead of ISO codes — use "CN" not "China"
✗Forgetting shippingTerms — DDP includes duties at checkout, DDU does not
✗Not including weight_kg — shipping cost estimate requires weight
✗Setting price as string with currency symbol — use numeric value only (25.00 not "$25.00")

How to use it

Get the HS code

Either provide an HS code directly or let POTAL auto-classify from a product name.

Specify origin and destination

Provide the origin country (where the product is made) and destination country (where it's being imported).

Call the calculate endpoint

POST /api/v1/calculate returns the full duty breakdown including MFN rate, preferential rates, and any trade remedies.

Check tariff optimization

The response includes tariffOptimization showing the best available rate and potential savings via FTAs.

API Reference

POST/api/v1/calculate

Request

{
  "productName": "Ceramic coffee mug",
  "price": 5,
  "origin": "CN",
  "destinationCountry": "US"
}

Response

{
  "totalLandedCost": 8.42,
  "breakdown": {
    "productCost": 5,
    "shippingCost": 0,
    "duty": 1.38,
    "tax": 0,
    "insurance": 0.04,
    "total": 8.42
  },
  "tariffOptimization": {
    "optimalRateType": "MFN",
    "savingsVsMfn": 0
  }
}

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":"Ceramic coffee mug","price":5,"origin":"CN","destinationCountry":"US"}'

Related Features

⚙️Total Landed Cost

Get the full import cost including duties, taxes, fees, and shipping

🌐FTA Detection

Identify applicable Free Trade Agreements across 63 FTAs

🌐Anti-dumping Duties

Check 119K+ trade remedy cases for anti-dumping duty exposure

⚙️De Minimis Check

Automatically check if shipment value falls below duty-free threshold

⚙️Currency Conversion

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

Having issues?

🐛 Report a Bug ❓ Ask a Question 💡 Suggest Improvement