{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/carriers/dhl-express-guide","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/docs/carriers/dhl-express-guide","default":true,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/carriers/dhl-express-guide","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"DHL Express","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"dhl-express","__idx":0},"children":["DHL Express"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://mydhl.express.dhl/us/en/home.html#/createNewShipmentTab"},"children":["DHL Express"]}," allows you to ship packages from the US, New Zealand, and most EU countries to destinations all over the world."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide provides developers with the details needed to build DHL Express shipping capabilities into your ShipStation API workflows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you wish to use the DHL Express services included with ShipStation API, visit the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/docs/carriers/dhlexpress-from-shipstation"},"children":["DHL Express from ShipStation guide"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required?"},"children":["Required?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nickname"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is a nickname for you to identify the carrier account in ShipStation API."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your DHL Express account number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your DHL Express account Site ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["password"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your DHL Express account password"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regCountry"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["enumerated string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 3166 two-character country code for the country where your DHL Express account is registered. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," DE,FR,US,NZ,BE,BG,CZ,DK,EE,IE,GR,ES,HR,IT,CY,LV,LT,LU,HU,MT,NL,AT,PT,PL,RO,SI,SK,FI,SE"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"shipping-requirements","__idx":2},"children":["Shipping Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Both weight and dimensions are required to successfully create a label."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Company name is required for both Ship From and Ship To addresses. If not provided, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," property value will be reused in the Company field."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-your-dhl-express-account","__idx":3},"children":["Connect Your DHL Express Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can connect a DHL Express account using the POST method to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/connections/carriers/"]}," endpoint, or via the ShipStation dashboard."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For instructions on connecting DHL Express via the dashboard, go to our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.shipstation.com/hc/en-us/articles/360025856252-DHL-Express"},"children":["DHL Express help article"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-via-endpoint","__idx":4},"children":["Connect via Endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_code"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dhl_express"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v2/connections/carriers/:carrier_code"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sample request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/connections/carriers/dhl_express HTTP/1.1\nHost: api.shipstation.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"nickname\": \"My DHL Express Account\",\n  \"account_number\": \"123456789\",\n  \"site_id\": \"your_site_id_here.\",\n  \"password\": \"your_password_here\",\n  \"regCountry\": \"US\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful connection will return a response with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]},", which you'll use for any requests for this account going forward."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rates","__idx":5},"children":["Rates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express supports ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/rates/rates"},"children":["rate shopping"]}," with ShipStation API, except for accounts based in New Zealand (however, we are working with DHL to provide this feature for NZ accounts)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-details","__idx":6},"children":["Service Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Available DHL Express services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /v2/carriers/:carrier_id/services"]}," endpoint at any time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"domestic-services","__idx":7},"children":["Domestic Services"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Service"},"children":["Service"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Code"},"children":["API Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Origin Countries"},"children":["Origin Countries"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic Express"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dhl_domestic_express"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BE, BG, CZ, DK, DE, EE, IE, GR, ES, FR, HR, IT, CY, LV, LT, LU, HU, MT, NL, AT, PT, PL, RO, SI, SK, FI, SE"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"international-services","__idx":8},"children":["International Services"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All services except Express Envelope have a max weight of 150 lb (70 kg) and max length of 118\" (300 cm) for individual international shipments. The total maximum weight for a multi-piece shipment is 2,200 lb (1,000 kg). Express Envelope has a max weight of 10 oz. Packages over those maximum values will not be accepted by DHL Express."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Service"},"children":["Service"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Code"},"children":["API Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Origin Countries"},"children":["Origin Countries"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Economy Select"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["economy_select"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DE, FR"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Express Worldwide"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["express_worldwide"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["US, NZ, BE, BG, CZ, DK, DE, EE, IE, GR, ES, FR, HR, IT, CY, LV, LT, LU, HU, MT, NL, AT, PT, PL, RO, SI, SK, FI, SE"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Express Worldwide Documents"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["express_worldwide_documents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["NZ"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Express Envelope"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["express_envelope"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["US"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Express Worldwide EU"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dhl_express_worldwide_eu"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BE, BG, CZ, DK, DE, EE, IE, GR, ES, FR, HR, IT, CY, LV, LT, LU, HU, MT, NL, AT, PT, PL, RO, SI, SK, FI, SE"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE: Action Required: New Zealand Border Levy Changes"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Effective April 1, 2026, a new NZD $2.21 (+ GST) levy applies to low-value air freight consignments entering New Zealand. This levy is charged ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["per consignment"]},", not per item."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shipping to New Zealand: Low Value Goods (LVG) Levy"]}," section in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/international"},"children":["International Shipments (ShipEngine guide)"]}," for full details."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE: DHL Shipping Unavailable to US Territories​"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Services for DHL (Express and Ecommerce) and DHL Express by ShipStation no longer support shipments to US territories."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"return-services","__idx":9},"children":["Return Services"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/returns"},"children":["Return services (ShipEngine guide)"]}," are not supported for this carrier"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"packages","__idx":10},"children":["Packages"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/carrier-packaging"},"children":["carrier package types (ShipEngine guide)"]}," are available for DHL Express services. To retrieve the most current package types dynamically, use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /v2/carriers/:carrier_id/packages"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Code"},"children":["API Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Package Attributes"},"children":["Package Attributes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Package"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["box"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["International"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also use the generic ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package"]}," type or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/custom-package-types"},"children":["custom package types (ShipEngine guide)"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shipment Dimensions and Weight Recommended!"]}," ","While many carriers may allow you to create a label without including package dimensions,"," ","we recommend always adding package dimension values to your shipment (with the notable exception of flat rate boxes). This will ensure more accurate rate estimates, especially for carriers that rely on ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://en.wikipedia.org/wiki/Dimensional_weight"},"children":["dimensional weight"]}," (also called DIM weight or volumetric weight)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"adding-shipment-insurance","__idx":11},"children":["Adding Shipment Insurance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express supports adding carrier insurance to your shipments. Review the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/insurance"},"children":["Parcel Insurance page (ShipEngine guide)"]}," for details on adding shipment insurance with ShipStation API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Visit the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://mydhl.express.dhl/us/en/ship/optional-services.html"},"children":["DHL Express Optional Services page"]}," to find the specific coverage amounts available for each country."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"label-support","__idx":12},"children":["Label Support"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Label sizes: 4\" x 6\", 4\" x 8\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Label formats: PDF"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"label-reference-fields","__idx":13},"children":["Label Reference Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express supports adding ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/labels/messages"},"children":["custom label messages (ShipEngine guide)"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Label messages will be printed on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ref"]}," field on the label and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reference"]}," field on the commercial invoice. If using multiple label message properties in your request, the messages will be combined into a single message with a 35-character maximum. Any additional characters will be trimmed from the field."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"multi-package-labels","__idx":14},"children":["Multi-Package Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express supports creating ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/multi-package"},"children":["multi-package shipments (ShipEngine guide)"]}," with all available services. DHL has 999-label maximum for multi-package shipments."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"label-branding","__idx":15},"children":["Label Branding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express does not support ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/labels/branding"},"children":["label branding (ShipEngine guide)"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"voiding-labels","__idx":16},"children":["Voiding Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API supports ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/labels/voiding"},"children":["voiding DHL labels (ShipEngine guide)"]},", but the void request is not sent to DHL. However, DHL Express does not charge an account holder unless the waybill is physically picked up and scanned into the network by a courier. If DHL does not pick up the waybill within 10 business days of its creation, it's automatically recycled."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"paperless-labels","__idx":17},"children":["Paperless Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express does not support ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/labels/paperless"},"children":["paperless labels (ShipEngine guide)"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"customs-declarations","__idx":18},"children":["Customs Declarations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customs declarations are submitted electronically, but the commercial invoice is available to download and print from the label response."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-confirmation","__idx":19},"children":["Delivery Confirmation"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Confirmation Type"},"children":["Confirmation Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Code"},"children":["API Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Electronic signature"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature is required for the shipment to be delivered. This signature may be a neighbor, building manager, or the recipient can authorize the release of the package (without being present)."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/delivery-confirmation"},"children":["Delivery Confirmation page (ShipEngine guide)"]}," for more details about using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmation"]}," property."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"advanced-options","__idx":20},"children":["Advanced Options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express supports certain ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/carriers/advanced-options"},"children":["advanced options (ShipEngine guide)"]},", which you can add to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment"]}," object when creating a shipment or label. To retrieve the most current advanced options dynamically, use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /v2/carriers/:carrier_id/options"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default Value"},"children":["Default Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_party"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["enumerated string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Determines which party is paying for shipping costs. This field must be used in conjunction with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_country_code"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_postal_code"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_account"]}," fields. Available values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipient"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["third_party"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered_duty_paid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates the shipment is DDP (that is, the shipper is paying the duties/taxes for the shipment rather than the recipient)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_machinable"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates that the package cannot be processed through sorting machines."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["saturday_delivery"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates that the carrier should charge for delivery on Saturday for services that do not otherwise include Saturday delivery."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"manifests","__idx":21},"children":["Manifests"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express does not require ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/manifests"},"children":["manifesting (ShipEngine guide)"]}," your shipments. For accounts based in the US, manifests are submitted electronically at the time of label creation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scheduling-pickups","__idx":22},"children":["Scheduling Pickups"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express supports scheduling pickups with ShipStation API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/pickups"},"children":["Schedule a Carrier Pickup page (ShipEngine guide)"]}," for more details about scheduling pickups using ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-points-pudo","__idx":23},"children":["Service Points (PUDO)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DHL Express does not support shipping to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/pick-up-drop-off/pudo-intro"},"children":["service points (ShipEngine guide)"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tracking","__idx":24},"children":["Tracking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API's integration with DHL Express supports receiving tracking updates. Review our ​",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/tracking/tracking"},"children":["Track a Package guides​ (ShipEngine guide)"]},"​ for details on tracking with the ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-notes","__idx":25},"children":["Integration Notes"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ioss-number-display","__idx":26},"children":["IOSS Number Display"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When shipping to the European Union using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/docs/shipping/tax-identifier-numbers#ioss-import-one-stop-shop"},"children":["IOSS (Import One-Stop Shop)"]}," scheme for low-value goods (≤€150), please note:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The IOSS number is stored in ShipStation API's shipment record and transmitted to DHL Express for customs clearance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The IOSS number will NOT appear on the printed commercial invoice"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This is expected behavior for DHL Express shipments using the IOSS scheme"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about IOSS and other tax identifiers, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/docs/shipping/tax-identifier-numbers"},"children":["Tax Identifier Numbers guide"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"international-tax-identifiers","__idx":27},"children":["International Tax Identifiers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating international shipments with customs declarations, DHL Express handles tax identifiers in the following ways:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Federal Tax ID and EORI numbers"]}," are transmitted electronically to DHL Express for customs clearance but do not appear on the printed commercial invoice"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Additional tax identifiers"]}," (when applicable) are included on the printed commercial invoice for customs compliance"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This ensures compliance with customs requirements while maintaining appropriate documentation for international shipments."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"disconnecting-your-dhl-express-account","__idx":28},"children":["Disconnecting Your DHL Express Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can disconnect a DHL Express carrier using the DELETE method with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/connections/carriers/"]}," endpoint, or via the ShipStation dashboard."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For instructions on disconnecting DHL Express via the dashboard, go to our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.shipstation.com/hc/en-us/articles/360025856252-DHL-Express"},"children":["DHL Express help article"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DELETE /v2/connections/carriers/:carrier_code/:carrier_id"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you disconnect a carrier account and reconnect it, the account will have a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," in ShipStation API."]}]}]},"headings":[{"value":"DHL Express","id":"dhl-express","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Shipping Requirements","id":"shipping-requirements","depth":3},{"value":"Connect Your DHL Express Account","id":"connect-your-dhl-express-account","depth":2},{"value":"Connect via Endpoint","id":"connect-via-endpoint","depth":3},{"value":"Rates","id":"rates","depth":2},{"value":"Service Details","id":"service-details","depth":2},{"value":"Domestic Services","id":"domestic-services","depth":3},{"value":"International Services","id":"international-services","depth":3},{"value":"Return Services","id":"return-services","depth":3},{"value":"Packages","id":"packages","depth":3},{"value":"Adding Shipment Insurance","id":"adding-shipment-insurance","depth":3},{"value":"Label Support","id":"label-support","depth":2},{"value":"Label Reference Fields","id":"label-reference-fields","depth":3},{"value":"Multi-Package Labels","id":"multi-package-labels","depth":3},{"value":"Label Branding","id":"label-branding","depth":3},{"value":"Voiding Labels","id":"voiding-labels","depth":3},{"value":"Paperless Labels","id":"paperless-labels","depth":3},{"value":"Customs Declarations","id":"customs-declarations","depth":3},{"value":"Delivery Confirmation","id":"delivery-confirmation","depth":2},{"value":"Advanced Options","id":"advanced-options","depth":2},{"value":"Manifests","id":"manifests","depth":2},{"value":"Scheduling Pickups","id":"scheduling-pickups","depth":2},{"value":"Service Points (PUDO)","id":"service-points-pudo","depth":2},{"value":"Tracking","id":"tracking","depth":2},{"value":"Integration Notes","id":"integration-notes","depth":2},{"value":"IOSS Number Display","id":"ioss-number-display","depth":3},{"value":"International Tax Identifiers","id":"international-tax-identifiers","depth":3},{"value":"Disconnecting Your DHL Express Account","id":"disconnecting-your-dhl-express-account","depth":2}],"frontmatter":{"seo":{"title":"DHL Express"}},"lastModified":"2026-07-22T16:58:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/docs/carriers/dhl-express-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}