API calculation requirements
Landed Cost calculates the import customs clearance charges when the carrier and service level are provided in the API request.
For a full list of acceptable service levels and codes, see the carrier service levels doc.
{ "shipping": { "amount": 14.23, "amount_discount": 0, "service_level": "ups_express_saver" }}Shipment rating feature
If you are using Zonos' Rating API to calculate your shipping costs, then the appropriate amount and service_level will be returned in the rating response, which can then be used in your landed cost request.
Checkout and Quoter use the shipment rating feature to calculate shipping, which automatically returns the shipping rate with clearance fees included.
{ "id": "ship_1Ce6vt2eZvKYlo2CrgzPqxaz", "amount": { "shipping": 23.51, "fuel": 29.11, "out_of_area": 25.71 }, "service_level": "ups_express_saver"}The amount and service_level can be used in the Landed Cost request.
Fees schema
The Landed Cost object contains the clearance fee charges and details inside the fees schema.
{ "fees": [ { "amount": 19.22, "description": "Handling Fee", "formula": "22 EUR", "item_id": null, "note": "An Post Handling Fee", "type": "advancement" } ]}Fees schema details
| Property↕ | Description↕ |
|---|---|
amount | The fee in the base currency (typically converted from another currency) |
description | The description of the fee by the clearance entity |
formula | Typically a set fee amount or percentage |
item_id | Reference to your item ID |
note | Additional information on the fee |
type | The type of fee charged, which is different than the entity’s description of their fee (advancement, brokerage, etc. See “Import clearance fees” table below) |
Fee types
Learn more by reading about different import fee types below.
Landed Cost guarantee
zonos_landed_cost_guarantee
Many merchants take advantage of the Landed Cost guarantee to simplify business processes and create peace of mind. With this service, Zonos will guarantee the landed cost calculations and handle all of the duty and tax registration, collection, payment, and reconciliation. An administrative fee for this service is built into the landed cost calculations.
Customize carrier import fees
Some clearance fees are negotiable, especially with UPS, FedEx, and DHL. If you have negotiated the DDP fee with UPS or FedEx, you can modify the fees inside the Dashboard. Navigate to Settings -> Shipping rates so that they are reflected correctly in your calculations. Customization is also available for DDP, advancement, and brokerage fees.

Import fees
Learn about import fees and how they are calculated.Import fees are variable fees that may be applied by brokers, government agencies, customs, and carriers. These fees can change based on many different factors, like the type of good or even the shipping service level that was used on the import.
An import is 39% more likely to be charged an import/clearance fee rather than a duty. Import fees are often overlooked and vary by country and carrier. Zonos Landed Cost calculates clearance fees by country, carrier, carrier service level, and currency to 235 different territories. View our landed cost guide to learn more about clearance fees and how they are applied to landed cost.