Calculate Landed Cost

What this endpoint does

This REST API calculates the total landed cost for shipping a cart of products internationally.
It determines all costs your customer will pay, including:

  • Duties
  • Import taxes
  • Other customs-related charges

Showing a fully landed cost upfront gives your international customers transparency at checkout, reduces delivery surprises, and helps you offer Delivered Duty Paid (DDP) shipping.

When to Use This API

  • During checkout: Calculate the total landed cost in real-time when the user enters a shipping address.
  • In the shopping cart: Let shoppers see estimated import charges before they even reach checkout.
  • Before creating a draft order: Validate total shipping costs so your system can show an accurate final price, including duties and taxes.

Key business benefits

  • Eliminate unexpected customs charges that cause cart abandonment.
  • Enable a DDP (Delivered Duty Paid) experience: you collect duties and taxes at checkout.
  • Improve international conversion rates by being upfront about total cost.
  • Optionally guarantee the estimate: if all required fields are provided, your business can absorb the final bill.

What this gives your merchants

  • One shipment → One or more ship-from → One or more shipping rates → Multiple items
  • The system returns duties, taxes, and fees* for each shipment and rate, so merchants can present accurate options at checkout.

How to ensure a guaranteed calculation

  • All required fields must be accurate.
  • Certain destination countries require Province/State and zip code to guarantee compliance.
  • If fields are missing, your calculation may be non-guaranteed and final charges could differ.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

This API uses JSON.

The required fields ensure accurate and guaranteed landed cost calculations.

All keys below must be included for a guaranteed calculation.

ship_to
object
required

Destination address.

string
required

Identifier for your app/service (e.g., "checkout-service").

string | null

External ID for traceability, like a cart ID or checkout session ID.

string
required

ISO 4217 currency code (e.g., USD, EUR).

number
required

Total order-level discount in major currency units (e.g., 10.00 means $10 off). Discount is split proportionally across products for duties/taxes.

shipments
array of objects
required

One or more shipments to calculate landed costs for. A shipment groups the items sent from a specific origin warehouse to the order's destination address.

shipments*
custom_properties
object | null

Any custom metadata your system wants to store (max 4 KB).

Headers
string
required

OpenBorder merchant API token

Responses

400

Invalid request payload received.

401

Invalid authorization token received.

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json