Use DHL Freight APIs to create your Road Freight order/shipment booking and receive your barcode labels for your Road Freight shipments.
To start using DHL Freight APIs, please validate below pre-conditions are met:
- You already must have a valid commercial contract which has account with DHL Freight (a so called Invoice Address ID = AccountID), your Road Freight product codes, your additional services names and incoterms. Assure yourself you have this already. If not, please get in contact with your country sales representatives or DHL Freight Customer Service as first step.
- Below Booking related API's only apply to standard domestic and international road freight products inside Europe. For Sweden domestic transports and for Sweden Domestic and International products, please go here: Sweden API Farm.
- Your technical setup, operational setup and acceptance tests should be done first in Sandbox environment of DHL API Developer Portal. Once all done, you have to handshake with your representative in DHL Freight as Country Onboarder about go-live date and any other preparations if needs.
- Before you begin your Sandbox tests, we strongly recommend that you carefully review the page for each API you are interested in, download and read the Product Manual, and use our certified sample JSON and YAML files; this path will answer many of questions while starting.
- UTAPI - Shipment Tracking Unified API allows you to track your shipments across all DHL Group Business Units, including DHL Freight.
- Please note that the APIs on these pages belong solely to DHL Freight.
Each of below DHL Freight API has been described in more detail on the respective API Reference pages in below list:
- The DHL Location Finder – Unified API provides a single interface to discover all DHL locations that handle parcels and letters, enabling customers during online checkout to choose nearby pick-up or drop-off (PUDO) points such as parcel lockers and view key details like available services and opening hours.
- New: Routing distance for Sweden: Get real driving‑distance calculations (in addition to airline distance) for Swedish locations, improving accuracy in checkout and location‑selection workflows.
Best for:
- Find locations easily: Search by address, geo‑coordinates, location ID, or keywordId for direct addressing.
- All networks, worldwide: Supports all parcel and letter forwarding networks worldwide (Post & Parcel Germany, DHL Express, DHL eCommerce, DHL Freight)
- All location types: Service points, post offices, postbank branches, lockers (including lean variants), PO boxes, and postboxes.
- Full service info: See which services each location supports, e.g. parcel/express pick‑up, drop‑off, unlabeled drop‑off, plus extras like letter‑service, postident, and age‑verification.
- Easy integration: Ideal for checkout delivery options, map‑based store locators, returns flows, and logistics planning.
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 valued customer,
DHL is modernizing its global API platform to ensure long‑term reliability, security, and scalability. Our goal is to complete this transition without impacting your service, but depending on your system setup, certain adjustments or checks may be required.
Potential Impacts & Recommended Actions
1. Header Names Will Be Lower‑Case Going Forward
After the modernization, all HTTP header names will be delivered back in lower‑case, as required by HTTP/2.
Previously, some headers may have appeared in Camel‑Case or UPPERCASE formats.
Header values remain unchanged.
Even when communication falls back to HTTP/1.1, header names will still appear in lower‑case.
Recommended actions:
* Ensure your system treats header names as case‑insensitive, as defined by the HTTP specification.
* If your applications rely on case‑sensitive header processing, please update them accordingly.
2. Updated Cipher Requirements for Encrypted Connections
The modernized platform supports only secure, up‑to‑date ciphers.
Older or insecure cipher configurations will no longer be accepted.
Recommended actions:
* Ensure your systems use any of the following ciphers:
* TLS 1.3
* TLS_AES_128_GCM_SHA256
* TLS_AES_256_GCM_SHA384
* TLS 1.2
* TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
* TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
Testing
To ensure a smooth transition, we recommend:
* Validating authentication, connectivity, and compatibility with your systems
Support
If you need assistance or have questions:
* Contact your DHL representative, or
* Submit a ticket via the Developer Portal Help Center: https://support-developer.dhl.com/support/tickets/new
Timeline
Unified Shipment Tracking (Pull and Push) changes will take place between 27th and 30th April.
Next Steps
* Review the three potential impact areas
* Prepare any required updates with your internal teams
* Reach out early if you require clarification
Thank you for your cooperation and continued partnership.
Your DHL 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
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.
Notifications
Price Quote (DHL Freight)
There have been content updates on the API Page Price Quote (DHL Freight).
You can have a detailed look at the changes by clicking the following link: Click here
Sincerely,
Your DHL API Developer Portal 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
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 API Developer Portal 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 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.