Site Logo

DHL Express Guide

DHL Express ShipEngine's integration with DHL Express allows you to ship packages from the US, Canada, UK, and Australia to supported countries all over the world. Visit the DHL Express website to open a business account today!

This guide provides developers an overview of shipping services that DHL Express offers and the service codes that you will use to create DHL Express shipments.

Connect Your Account

ShipEngine API allows you to connect your DHL Express accounts programmatically without logging in to the ShipEngine API dashboard. This is useful if you have wrapped a custom UI around the ShipEngine API toolset and want to add or disconnect existing carrier accounts without exposing your end users to the API dashboard.

These APIs can be used in parallel with the ShipEngine Partner APIs to programmatically create new ShipEngine users, and then connect existing DHL Express accounts all via the API without logging into a dashboard. Together these APIs empower you to completely white-label the ShipEngine experience for your end users.

Continue below for instructions on how to programatically connect DHL Express using the ShipEngine API.

For instructions on connecting DHL Express via the ShipEngine dashboard, go to our DHL Express help article.

DHL Express Account Information Model

PropertyDescriptionType
nicknameThis is a nickname for you to identify the carrier account in ShipEngine.string, required
account_numberAccount Numberstring, required
site_idSite IDstring, required
PasswordPasswordstring, required

Example POST Call

POST /v1/connections/carriers/DHL Express

1
2
3
4
5
6
7
8
9
10
11
POST /v1/connections/carriers/DHL Express HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
"nickname": "My DHL Express Account"
"account_number": "123456789",
"site id": "your_site_id_here.",
"password": "your_password_here",
}

Example POST Response

Your account will now appear in your carriers list with an assigned carrier_id that you will specify when creating DHL Express shipments.

1
2
3
{
"carrier-id": "se-1234567"
}

Scheduled Pickups with DHL Express

DHL Express supports scheduled pickup. You can use the Schedule Pickup endpoint to book pickups with DHL Express.

DHL Express US Service Details

(Click to open)

International Services

ServiceService API Codes
Express Envelopeexpress_envelope
Express Worldwideexpress_worldwide

DHL Express Australia Service Details

(Click to open)

International Services

ServiceService API Codes
Express Worldwide Dutiabledhl_australia_express_worldwide_dutiable
Express Worldwide Non-Dutiabledhl_australia_express_worldwide_non-dutiable

DHL Express Canada Service Details

(Click to open)

International Services

ServiceService API Codes
Economy Selectdhl_canada_economy_select
Express 9:00dhl_canada_express_worldwide_900
Express 9:00 Documentsdhl_canada_express_worldwide_900_documents
Express 10:30dhl_canada_express_worldwide_1030
Express 10:30 Documentsdhl_canada_express_worldwide_1030_documents
Express 12:00dhl_canada_express_worldwide_1200
Express 12:00 Documentsdhl_canada_express_worldwide_1200_documents
Express Worldwidedhl_canada_express_worldwide
Express Worldwide Documentsdhl_canada_express_worldwide_documents

DHL Express UK Service Details

(Click to open)

Domestic Services

ServiceService API Codes
Domestic Expressdhl_uk_domestic_express
Domestic Express 9:00dhl_uk_domestic_express_900
Domestic Express 12:00dhl_uk_domestic_express_1200

International Services

ServiceService API Codes
Economy Selectdhl_uk_economy_select
Economy Select EUdhl_uk_economy_select_eu
Express 9:00dhl_uk_express_worldwide_900
Express 9:00 Documentsdhl_uk_express_worldwide_900_documents
Express 10:30dhl_uk_express_worldwide_1030
Express 10:30 Documentsdhl_uk_express_worldwide_1030_documents
Express 12:00dhl_uk_express_worldwide_1200
Express 12:00 Documentsdhl_uk_express_worldwide_1200_documents
Express Worldwidedhl_uk_express_worldwide
Express Worldwide Documentsdhl_uk_express_worldwide_documents
Express Worldwide EUdhl_uk_express_worldwide_eu

Packages

NameAPI CodePackage Attributes
PackageboxInternational

Return Services

Return services not supported for this carrier. If supported, list needed details here.

Review the Return Shipping Labels page for details on creating return labels with ShipEngine.

Adding Shipment Insurance

DHL Express supports adding insurance to your shipments. Visit the DHL Express Optional Services page to find the specific coverage amounts available for each country.

Review the Parcel Insurance page for details on adding shipment insurance with ShipEngine.

Advanced Options

DHL Express supports the following advanced options:

OptionPropertyOption API Codes
Third Party Billingbill_to_partyenumerated string
recipient or third_party
Bill Duties and Taxes to Payor of Shipping Chargesdelivery_duty_paidboolean
This shipment is non-machinablenon_machinableboolean

To ensure you always have the most up-to-date information, use the List Carrier Advanced Options call.

You are now ready to create shipments using DHL Express via ShipEngine!