Use DHL Freight's Road Freight APIs to create your road freight order/booking and receive your barcode labels for your road freight shipments.
For public tracking you can use the UTAPI - Shipment Tracking Unified API, that allows you to track your shipment across all DHL Group Business Units (including DHL Freight).
To start using DHL Freight APIs, please validate below pre-conditions:
- You already must have an commercial contract which has account with DHL Freight (a so called Invoice Address ID), your freight product codes and your additional services names. Assure yourself you have this already. If not, please get in contact with your country sales representatives or DHL Freight Customer Service.
- For now, below Booking related API's only apply to standard domestic and international road freight products inside Europe. For Sweden domestic transports and for Sweden Parcel products, please go here: Sweden API Farm.
- Sales Invoice Push API can be used independently for all invoices you received from DHL Freight. Since this is a push API with different logic, do not combine this API in your APP with below described transportation related API's.
- Your technical setup, operational setup and acceptance tests should be done first in Sandbox environment of DHL Developer Portal. Once all done, you have to handshake with your country sales representatives, country API on-boarder or Customer Service about go-live date and any other preparations if needs.
Each of below DHL Freight API has been described in more detail on the respective API Reference pages in below list
Best for:
- Providing access to the shipment status at any time
- Integrating all types of DHL shipments
- Multiple shipments (e.g. eCommerce, Express, Freight, Letter, Parcel, etc.)
Notifications
Dear all,
We are thrilled to announce a major release for DHL Freight shipments in our Unified Shipment Tracking API (UTAPI), packed with exciting new features designed to enhance your experience!
What’s New:
- Push Notifications: Stay updated in real-time with critical shipment information through push notifications at both shipment and account levels.
- Estimate Date of Delivery (EDD): The Estimate Date of Delivery is now publicly available without the need to pass the postal code challenge.
- Pickup Date: Pickup dates are now included in the tracking information.
- References: Additional DHL Freight Shipment IDs are now included.
- Improved Performance: Experience drastically increased response times and enhanced error handling.
Planned Go Live Date: January 30, 2025
Cutover Information:
The changes will only apply to shipments created after 11:00 CET on January 30, 2025. Shipments created before this time will behave as usual and will retain their existing tracking features.
Action Required: While no immediate changes are necessary, we encourage you to explore the new features. Please review your current integrations to ensure they will work seamlessly and check out the updated documentation on our developer portal for all the details.
Thank you for your continued support!
You are receiving this message because you have subscribed to notifications on the DHL API Developer Portal. If you want to unsubscribe from notifications click here: Cancel Subscription
We are pleased to announce the deployment of a new feature, scheduled for September 14th, 2024.
This update introduces the capability to include an offset in timestamps for express shipments, providing enhanced flexibility and precision in representing local times across different time zones.
Feature Overview:
With this update, the timestamp will now include a time zone offset. This change improves the handling of timestamps, particularly for global applications, ensuring that the local time is accurately represented according to the location's time zone.
Example Code Before the Change (No Offset):
Previously, the payload did not include any offset, as shown below:
"status": {
"timestamp": "2024-06-03T11:38:00",
"location": {
"address": {
"addressLocality": "SAN FRANCISCO - California - USA",
"countryCode": "US"
}
}
}
Example Code After the Change (With Offset):
With the new feature, the payload will include the time zone offset:
"status": {
"timestamp": "2024-06-03T11:38:00+07:00",
"location": {
"address": {
"addressLocality": "SAN FRANCISCO - California - USA",
"countryCode": "US"
}
}
}
In this example, the timestamp includes the offset +07:00, indicating the time zone difference from UTC.
Benefits of the Update:
- Accurate Timezone Representation: The timestamp will now reflect the correct local time with the offset, improving accuracy for international users and applications.
For any questions or assistance, please feel free to reach out to our support team.
Best Regards
Benjamin Baschab
API Center of Excellence
You are receiving this message because you have subscribed to notifications on the DHL API Developer Portal. If you want to unsubscribe from notifications click here: Cancel Subscription
Dear,
We are excited to announce enhancements in tracking for shipments via "freight". The upcoming update will rectify an issue where the event description appears under "status" and "description".
Additionally, we will introduce a more detailed code within the "status" element. Below, you can find a comparison of the current and future message formats.
This fix will be deployed 14th August, 11:00 CET you may experience a short disruption on tracking freight shipments during deployment.
Enumerations for Freight and status are available in our download section https://developer.dhl.com/api-reference/shipment-tracking?language_content_entity=en#downloads-section
Current Format:
{
"shipments": [
{
"id": "7135274780",
"service": "freight",
. . .
"statusCode": "delivered",
"status": "Received by consignee",
"description": "Received by consignee"
},
Future Format:
{
"shipments": [
{
"id": "7135274780",
"service": "freight",
. . .
"statusCode": "delivered",
"status": "24-600",
"description": "Received by consignee"
},
Sincerely,
Best Regards
Benjamin Baschab
API Center of Excellence
You are receiving this message because you have subscribed to notifications on the DHL API Developer Portal. If you want to unsubscribe from notifications click here: Cancel Subscription
Shipment Tracking - Unified
Dear,
🚀 I am are excited to inform you of a significant enhancement to our UTAPI Portfolio. We have now integrated Shipment Tracking of PPL shipments (www.ppl.cz ). This release is a notable advancement in our ongoing effort to deliver exhaustive shipment tracking data within the DHL group to our customers.
🚚Tracking shipments of PPL is now utilizing both our traditional Pull and our new Push API interface. This release integrates smoothly with our current offering without requiring any modifications for existing UTAPI users.
There's no need for any changes for those using UTAPI just start tracking and enjoy the benefits our unified solution offers.
🔜 Looking ahead, we are committed to further enhancing the UTAPI Portfolio by incorporating futher products.
Benjamin Baschab
API Center of Excellence
DHL Group
Heinrich-Brüning-Str. 5
53113 Bonn
Germany
You are receiving this message because you have subscribed to notifications on the DHL API Developer Portal. If you want to unsubscribe from notifications click here: Cancel Subscription
Introducing Estimated Delivery Date (EDD) for Parcel DE Shipments
We are excited to announce the launch of the Estimated Delivery Date (EDD) feature for Parcel DE shipments, which was successfully deployed on July 1st at 12:15 CET. This new enhancement provides customers with a more precise delivery window, offering greater convenience and improved planning capabilities.
With EDD, you can now see the expected delivery date and time frame for your shipments, enhancing transparency and improving the overall customer experience. This feature is designed to give you better visibility into the delivery process, ensuring you can make arrangements accordingly.
Example Snippet
Below is an example of how the EDD information will be displayed in your shipment data:
{
"shipments": [
{
"id": "00340434657234111097",
"service": "parcel-de",
"origin": {
"address": {
"countryCode": "DE"
}
},
"destination": {
"address": {
"countryCode": "DE"
}
},
"status": {
"timestamp": "2024-07-02T07:21:00",
"statusCode": "transit",
"status": "PO",
"description": "Being delivered.",
"remark": "Being delivered."
},
"estimatedTimeOfDelivery": "2024-07-02",
"estimatedDeliveryTimeFrame": {
"estimatedFrom": "2024-07-02T09:00:00",
"estimatedThrough": "2024-07-02T10:30:00"
}
}
]
}
In this example, the shipment is scheduled to be delivered on July 2, 2024, with an estimated delivery time frame between 09:00 AM and 10:30 AM.
Key Benefits
- Increased Accuracy: Know the exact day and time frame your shipment will arrive.
- Improved Planning: Plan your day better with a precise delivery window.
- Enhanced Transparency: Stay informed about the status and progress of your shipment.
We believe this new feature will greatly enhance your shipping experience by providing timely and accurate delivery information. Thank you for choosing our service, and we look forward to continually improving to meet your needs.
For any questions or further assistance, please contact our support.
Best Regards
Benjamin Baschab
API Center of Excellence
DHL Group
Heinrich-Brüning-Str. 5
53113 Bonn
Germany
You are receiving this message because you have subscribed to notifications on the DHL API Developer Portal. If you want to unsubscribe from notifications click here: Cancel Subscription
Best for:
- Providing access to the shipment status at any time
- Integrating all types of DHL shipments
- Multiple shipments (e.g. eCommerce, Freight, Letter, Parcel, etc.)
This is the push version of the Shipment Tracking Unified API which proactive sends updates.
Notifications
Dear,
I'm excited to announce that UTAPI Push rollout continues and now also supports” parcel_nl” Shipments.
This development marks a significant advancement in UTAPI’s push coverage, enabling you to subscribe and receive updates for Parcel NL (eCommerce) shipments, just as you do with other services, and to enjoy all the benefits that a push solution provides.
Best Regards
Benjamin Baschab
API Center of Excellence
DHL Group
Heinrich-Brüning-Str. 5
53113 Bonn
Germany
Mobile.: +49 151 18000 309
Landline: +49 228 29971 913
E-Mail: Benjamin.Baschab@dhl.com
Internet: https://www.dhl.com
You are receiving this message because you have subscribed to notifications on the DHL API Developer Portal. If you want to unsubscribe from notifications click here: Cancel Subscription
Best for:
To validate which DHL Freight additional services can be combined to each product and how they can be combined with each other.
Precondition:
- For existing DHL Freight business customers with a valid contract.
- For domestic and international palletized road freight transport orders (> 35 kg) across Europe.
For this DHL Freight API, we offer a service that will inform you about its important updates; you can subscribe to this service by using the NOTIFICATION button on right hand side of this page.
This API provides authentication services for some of DHL Group's APIs.
Note: This Authentication API works only for a set of DHL Group's APIs. Please read the documentation of the API you are trying to use to know whether this Authentication API is the one to provide authentication services for you.
Best for:
To get a price quote for a planned Road Freight shipment with DHL Freight.
Precondition:
- For existing DHL Freight business customers with a valid contract.
- For domestic and international palletized road freight transport orders (> 35 kg) across Europe.
- Customer must already have an eID (user/password)
For this DHL Freight API, we offer a service that will inform you about its important updates; you can subscribe to this service by using the NOTIFICATION button on right hand side of this page.
Best for:
- Creating your barcode labels (GS1 or ANSIFACT)
- Creating other documents e.g. CMR, shipment list
All documents are returned in base64 that you need to convert into PDF.
Precondition:
- For existing DHL Freight business customers with a valid contract.
- For domestic and international palletized road freight transport orders (> 35 kg) across Europe.
For this DHL Freight API, we offer a service that will inform you about its important updates; you can subscribe to this service by using the NOTIFICATION button on right hand side of this page.
Best for:
- Determining DHL Freight (Europe) available product codes for your business region
Precondition:
- For existing DHL Freight business customers with a valid contract.
- For domestic and international palletized road freight transport orders (> 35 kg) across Europe.
For this DHL Freight API, we offer a service that will inform you about its important updates; you can subscribe to this service by using the NOTIFICATION button on right hand side of this page.
Best for:
- Creating domestic and international palletized road freight transport orders (> 35 kg) across Europe with DHL Freight.
Precondition:
- For existing DHL Freight business customers with a valid contract.
For this DHL Freight API, we offer a service that will inform you about its important updates; you can subscribe to this service by using the NOTIFICATION button on right hand side of this page.
Notifications
Shipment Booking (DHL Freight)
There have been content updates on the API Page Shipment Booking (DHL Freight).
You can have a detailed look at the changes by clicking the following link: Click here
Sincerely,
Your DHL Freight API Team
You are receiving this message because you have subscribed to notifications on the DHL API Developer Portal. If you want to unsubscribe from notifications click here: Cancel Subscription
Shipment Booking (DHL Freight)
There have been content updates on the API Page Shipment Booking (DHL Freight).
You can have a detailed look at the changes by clicking the following link: Click here
Sincerely,
Your Freight API Farm Team @ DHL API Developer Portal
You are receiving this message because you have subscribed to notifications on the DHL API Developer Portal. If you want to unsubscribe from notifications click here: Cancel Subscription
Best for:
- Determining available DHL Freight product code(s) and estimated or committed delivery date for a requested pickup date and departure/arrival country.
- Only for road freight groupage shipments that are transported via DHL Freight terminals. Relevant only for terminal based operations (TBO), not relevant for part/full loads (non-Terminal based operations / NTBO).
Precondition:
- For existing DHL Freight business customers with a valid contract.
- For domestic and international palletized road freight transport orders (> 35 kg) across Europe.
For this DHL Freight API, we offer a service that will inform you about its important updates; you can subscribe to this service by using the NOTIFICATION button on right hand side of this page.
Here are some tips that'll show you, how to navigate through the Developer Portal to find the APIs, fitting best to your business:
Browse API catalog:
Filtering APIs: If you browse through the API catalog you can use the left side filter navigation to enclose the shown APIs.
If you know the Division in which the product your API serves lies, please check the Division box to filter the APIs (e.g. DHL Freight). Another common way is to filter APIs by Service Type (e.g. Location / Shipping / Transportation / Tracking).
APIs Business Use Cases: Now, that you have filtered the APIs to a smaller amount, you should have a closer look at the API Teaser. The section "Best for" explains the business use case of the API and you'll find also the geographical location, where the API is available. You can find even more information of the API use case.