New Product Code for international shipping

📘
Executive Summary
As of October 1, 2025, our new international shipping product is live, allowing customers pay duties and taxes upfront for a guaranteed total price.
The new product code is STANDARD-DDP-PICKUP. This feature will be enabled on the new POST /products endpoint for quoting and the existing POST /orders endpoint for booking.

Changes

The new Serviceable products endpoint and Create an order endpoint now support quoting and creating international orders with duties and taxes paid upfront (DDP).

To use STANDARD-DDP-PICKUP product, you must include a detailed parcel_contents object for each unique item in the parcel:

description: A detailed description of the item for customs.
value: The value of a single unit of the item.
quantity: The number of units of this item. Defaults to 1.
country_of_origin: The two-letter (ISO 3166-1 alpha-2) country code where the goods were manufactured.
hs_code: The 10-digit Harmonized System code. HS codes are required for each item being shipped to determine accurate duties and taxes
Manufacturer_id: may be required for certain items to clear US Customs

In addition the inclusion of a descriptor for the whole parcel

Contents_type: Allowed values are Documents, Gift, Merchandise,Returned Goods, Sample, Other.

Updated API Response

When duties apply, the price_breakdown object in the response will include a new duties object.

amount: The total value of the duties and taxes.
currency: The currency of the amount.

Example:

  "price_breakdown": {
      "base": {
        "amount": 15,
        "currency": "AUD"
      },
      "discount": {
        "amount": -7.5,
        "currency": "AUD"
      },
      "cover": {
        "amount": 0,
        "currency": "AUD"
      },
      "fuel_surcharge": {
        "amount": 0.2,
        "currency": "AUD"
      },
      "base_tax": {
        "amount": 1.5,
        "currency": "AUD"
      },
      "discount_tax": {
        "amount": -0.75,
        "currency": "AUD"
      },
      "cover_tax": {
        "amount": 0,
        "currency": "AUD"
      },
      "fuel_surcharge_tax": {
        "amount": 0.02,
        "currency": "AUD"
      },
      "service": {
        "amount": 1,
        "currency": "AUD"
      },
      "duties": {
        "amount": 1.5,
        "currency": "AUD"
      }
    }

We also have this help centre article explaining Customs, import tax and duty payments in more detail.