DHL

Declare a value for packages when shipping with DHL.

Declared value for packages

When shipping with DHL, you may optionally declare a value for the package being shipped. To declare a package value, you'll include the optional fields in the table below as part of the shipmentParameters in your API call.

Reference fieldRequired/OptionalField propertiesDescription
totalDeclaredValue .declaredValueOptionalNumber ($float)
Ex.: 500
The value to be passed through as the total monetary amount of the declared value for the package. This is what will be reimbursed if the package is damaged. If the declared value exceeds the carrier's free threshold, there may be a surcharge for passing a declared value.
totalDeclaredValue .currencyCodeOptionalString
Ex.: usd
The currency code for the declared value

A snippet of the JSON request for the API call with the required fields is included. This example is for a single-parcel shipment. A multi-parcel shipment would be included in multiParcelShipmentParameters.

{
"shipmentParameters": {

   "totalDeclaredValue": {
        "declaredValue": 5000,
        "currencyCode": "usd",
 ...
     }
}

Resources

Your Shipium team member is available to help along the way. However, you might find these resources helpful: