Quote shipment fees
Calculate landed cost (duties, taxes, additional country charges, and additional fees) for a hypothetical shipment without persisting any data. Use at checkout to show the consignee the total before they pay. Identical fee logic to POST /api/shipments/.
Request Body required
Section titled “Request Body required ”object
Brand ID or slug. Required when using an organization-level API key; optional when the key is brand-scoped.
ISO 4217 currency code for the quote
List of items to quote. At least one item is required.
object
Product description for customs classification. Used together with the HS code to validate and refine the item’s classification for the destination country.
Declared value of a single unit in the shipment currency
ISO 3166-1 alpha-2 country code where the item was manufactured
Number of units of this item
6-10 digit Harmonized System code. Used together with the description for tariff calculation.
Total value for all units. If omitted, calculated as declared_value * quantity.
Shipping cost for this line item, regardless of quantity. Added to the duty/tax base by the customs engine. Internal — not shown to the consignee.
EU IOSS registration for VAT (EU destinations only). When true, import VAT is not charged at the border. Omit to use the brand’s default setting.
Sender origin, used to determine the export country for the quote.
object
ISO 3166-1 alpha-2 origin country code
Consignee destination, used to determine the import country for the quote.
object
ISO 3166-1 alpha-2 destination country code
Responses
Section titled “ Responses ”Successful Response
object
Quote currency (ISO 4217)
Total duty amount across all items
Total tax amount across all items
Destination-country surcharges imposed in addition to duties and taxes
Total of all additional fees configured for the brand. Includes pre-customs fees that inflate the duty base; their per-item effect is reflected in the items’ declared values used for the calculation.
Grand total: duties + taxes + additional country charges + additional fees
Line items with duty/tax breakdown
object
Original item description as submitted
Resolved item description after customs classification
HS code as submitted
HS code resolved by Duty Pro for the destination country
Resolved import HS code for the destination country
Resolved export HS code for the origin country
Country of origin (ISO 3166-1 alpha-2)
Declared value per unit
Number of units
Total value for all units
Shipping cost for this line item, regardless of quantity
Calculated duty amount for this item
Calculated tax amount for this item
Additional fees applied to the quote. Pre-customs fees are included so the merchant can see why the duty base may differ from the submitted declared values.
object
Fee type identifier
Human-readable fee name shown to the consignee
Fee amount in the shipment currency
Fee amount in its original currency before conversion
Original currency of the fee before conversion
Validation Error