Landed Cost Calculator API

📘

Developer documentation for the Landed Cost Calculator API is available here.

The Landed Cost Calculator API simplifies global trade by automating duty and tax calculation. Ensuring accurate, real-time calculations so you can ship confidently, stay compliant, and provide customers with clear cost expectations at checkout.

Key features

• Comprehensive Landed Cost Calculation - Calculates duties, VAT/GST, excise, and additional import taxes to give a full breakdown of cross-border costs.
• Auto-classification of products - No need to pre-classify every product - the API can classify items using product titles or partial HS codes. For maximum accuracy, product taxonomy and classification IDs can be used.
• Detailed calculation notes - Responses include explanatory notes such as thresholds, duty applicability, tax breakdowns, and compliance restrictions (e.g. lithium battery handling rules).
• Flexible use cases - Designed for ecommerce platforms (to show customers accurate checkout costs and DDP/DAP options) and logistics providers (to display full cost breakdowns and book shipments).
• Leverages the product taxonomy - Provides a four-level product classification tree mapped to HS codes worldwide, ensuring accuracy in duties and tax rates.

Getting started

Plan & API keys

Once you have a plan with API access, you can retrieve your API key:

1. Login to your Dutify account.
2. Navigate to Account → API Access.
3. Copy your API key from the top of the page.

Endpoints

Here is a snapshot of the endpoints you will need to get setarted, full documentation is here.

• Landed Cost Calculator
  • POST /api/v1/landed_cost_calculator - Calculate the landed cost for a shipment/order.
  • GET /api/v1/landed_cost_calculator/{landed_cost_result_id} - Retrieve an existing landed cost calculation.
• Other useful endpoints
  • GET /api/v1/countries - Retrieves a list of supported countries.
  • GET /api/v1/currencies - Retrieves a list of all supported currencies.
  • GET /api/v1/product_classifications - Retrieves the product taxonomy tree.

Example implementation: ecommerce

An ecommerce retailer that sells products to customers worldwide and ships DDP.

1. Classification
   1. Pre-classify your product catalog using our product taxonomy by using api/v1/product_classifications to retrieve and store a product_classification_id for each SKU.
   2. Or, use your product titles to auto-classify as part of the calculation request.
2. Cart & checkout
   1. When an international customer lands on your cart or checkout, send the cart information to api/v1/landed_cost_calculator and display and collect the duty and tax.
3. Shipping
   1. Save the full destination HS code and shipping restrictions to the order and automate syncing to your 3PL provider for streamlined fulfilment and smoother customs clearance.

Example implementation: logistics

A shipping platform that allows customers to choose from multiple shipping services to send their goods cross-border.

1. Classification
   1. Use the api/v1/product_classifications endpoint to retrieve and display our user friendly product taxonomy within your platform to enable self-serve classification.
   2. Or, leverage HS codes and product descriptions to auto-classify as part of the calculation request.
2. Calculation
   1. Send a request for each shipping option to api/v1/landed_cost_calculator and display the total landed cost or an itemized breakdown of duties and taxes for each option.
3. Confirmation
   1. Display compliance messaging and shipping restrictions to the customer, and automatically provide the carrier with the full destination HS code to ensure smooth customs clearance.

FAQs