Find the key/value pairs in a landed cost request.
Although Zonos Landed Cost is able to provide an accurate landed cost based soley on the description of an item, the more information that is provided, the more accurate the landed cost quote will be. Below are REQUIRED and OPTIONAL inputs, but it's recommended to fill in as many OPTIONAL fields as possible.
An HS code is highly recommended. Unlike the basic landed cost, the complete landed cost will include item-level detail of the duty rates per HS code.
The information related to any discounts, including the id, amount, and any details.
discounts.id OPTIONAL
The unique discount identifier for the merchant or exporter.
discounts.amount OPTIONAL
A decimal with the amount of the discount, in dollars and cents.
discounts.detail OPTIONAL
Additional features, attributes, or descriptions of the discount.
items REQUIRED
The list of items being exported. hash
items.id REQUIRED
The unique item identifier for the merchant or exporter.
items.amount REQUIRED
A decimal with the total of one single item, in dollars and cents.
items.amount_discount OPTIONAL
The amount of the discount that applies to the item.
items.brand OPTIONAL
The brand of the item, e.g., Leatherman.
items.category OPTIONAL
Category description of the item, e.g., Clothing.
items.color OPTIONAL
Color of the item.
items.country_of_origin OPTIONAL
The country of manufacture or production, represented by a two-letter ISO code. This is recommended for the most accurate quotes. If no country of origin is received, the Most Favored Nation (MFN) rate is used.
items.description_customs OPTIONAL
The suggested description of goods for the commercial invoice. This description will usually differ from a retail description and will typically include a general description of what it is, what it is made from, and what it is used for.
items.description_retail OPTIONAL
The retail description of the item.
items.detail OPTIONAL
Additional features, attributes, or descriptions of the item.
items.dimensions OPTIONAL
The size of the shipment. This is recommended to get the most accurate quotes into countries where tariffs are impacted by the dimensions of the item. hash
items.dimensions.height OPTIONAL
A decimal for the height of the item.
items.dimensions.length OPTIONAL
A decimal for the length of the item.
items.dimensions.unit OPTIONAL
The unit of measurement for the item dimensions.Possible values are inch, centimeter, millimeter, and null.When null, inch will be used.
items.dimensions.width OPTIONAL
A decimal for the width of the item.
items.duty_tax_fee_free OPTIONAL
A string to specify if the item should not be included in the landed cost calculation. When exclude is sent in the request, the item will show up in removed_items in the API response.
items.hs_code OPTIONAL
Item HS code, 2 to 10 digits.
items.image_url OPTIONAL
The image URL.
items.quantity REQUIRED
An integer with the quantity of the item.
items.upc_code OPTIONAL
The UPC code string for the item.
items.weight OPTIONAL
A decimal for the weight of the item.
items.weight_unit OPTIONAL
The unit of measurement string for the weight.Possible values are pound, ounce, kilogram, and null.When null, pound will be used.
landed_cost OPTIONAL
The type of request for a landed cost.Possible values include delivery_duty_paid and delivery_duty_unpaid.The fees for a landed cost can differ, whether it is sent DDP or DDU. If null, a DDP request will be assumed.If a DDP request is made and DDP is not available, a 400 error will be returned with a message stating that DDP is not available for the service level provided.DDP and DDU are typically both available within each service level, so please ensure that this can be configured on a per-service level basis instead of account-level.
sale_type OPTIONAL
An indicator of the type of sale.Possible values include not_for_resalefor_resale.If null a not_for_resale request will be assumed.
Request a landed cost
Request a landed cost
Find the key/value pairs in a landed cost request.Although Zonos Landed Cost is able to provide an accurate landed cost based soley on the description of an item, the more information that is provided, the more accurate the landed cost quote will be. Below are REQUIRED and OPTIONAL inputs, but it's recommended to fill in as many OPTIONAL fields as possible.
Attributes
JSON key/value pairs in the request body
POST |
https://api.zonos.com/v1/landed_costHEADER
zonos-version: 2019-11-21currencyREQUIREDdiscountsOPTIONALdiscounts.idOPTIONALdiscounts.amountOPTIONALdiscounts.detailOPTIONALitemsREQUIREDhashitems.idREQUIREDitems.amountREQUIREDitems.amount_discountOPTIONALitems.brandOPTIONALitems.categoryOPTIONALitems.colorOPTIONALitems.country_of_originOPTIONALitems.description_customsOPTIONALitems.description_retailOPTIONALitems.detailOPTIONALitems.dimensionsOPTIONALhashitems.dimensions.heightOPTIONALitems.dimensions.lengthOPTIONALitems.dimensions.unitOPTIONALinch,centimeter,millimeter, andnull.Whennull,inchwill be used.items.dimensions.widthOPTIONALitems.duty_tax_fee_freeOPTIONALexcludeis sent in the request, the item will show up inremoved_itemsin the API response.items.hs_codeOPTIONALitems.image_urlOPTIONALitems.quantityREQUIREDitems.upc_codeOPTIONALitems.weightOPTIONALitems.weight_unitOPTIONALpound,ounce,kilogram, andnull.Whennull,poundwill be used.landed_costOPTIONALdelivery_duty_paidanddelivery_duty_unpaid.The fees for a landed cost can differ, whether it is sent DDP or DDU. Ifnull, a DDP request will be assumed.If a DDP request is made and DDP is not available, a 400 error will be returned with a message stating that DDP is not available for the service level provided.DDP and DDU are typically both available within each service level, so please ensure that this can be configured on a per-service level basis instead of account-level.sale_typeOPTIONALnot_for_resalefor_resale.Ifnullanot_for_resalerequest will be assumed.ship_from_countryREQUIREDship_toREQUIREDhashship_to.cityOPTIONAL*ship_to.countryREQUIREDship_to.postal_codeOPTIONAL*ship_to.stateOPTIONAL*shippingREQUIREDhashshipping.amountREQUIREDshipping.amount_discountOPTIONALshipping.service_levelREQUIRED{"currency": "USD","discounts": [{"id": "sale124","amount": 43,"detail": null}],"items": [{"id": "294395","amount": 75,"amount_discount": 0,"brand": null,"category": "Women's Clothing","color": null,"country_of_origin": "FR","description_customs": null,"description_retail": "Hoka One Running Shoe - Women's","detail": null,"dimensions": {"height": 4,"length": 6,"unit": "inch","width": 11},"duty_tax_fee_free": null,"hs_code": "6116.10.00","image_url": "https://zonos.com/images/handbag.webp","quantity": 1,"upc_code": null,"weight": 10,"weight_unit": "pound"},{"id": "294396","amount": 15,"country_of_origin": "CN","country_of_origin_source": "account_default","description_customs": "Men's t-shirt 100% polyester","description_retail": "Galaxy Quest Men's Tee Blue","detail": null,"dimensions": {"height": 4,"lenght": 6,"unit": "inch","width": 11},"duty_tax_fee_free": "exclude","hs_code": "6217.10","image_url": null,"note": null,"quantity": 1,"upc_code": null,"weight": 1,"weight_unit": "pound"}],"landed_cost": "delivery_duty_paid","sale_type": "not_for_resale","ship_from_country": "US","ship_to": {"city": "Campinas","country": "BR","postal_code": "75828-000","state": "SP"},"shipping": {"amount": 14.23,"amount_discount": 0,"service_level": "ups_express_saver"},"tariff_rate": "zonos_preferred"}Was this page helpful?