With Deutsche Post & DHL APIs, you can quickly and easily use our solutions for logistics and dialog marketing and extend your web services with useful information. Using our APIs, you can create shipping labels and Internet stamps, query shipment status or integrate our services into your online store.
Easy-to-use step-by-step instructions guide you through the entire connection process. Detailed documentations, code examples, video tutorials and extensive FAQs on the respective API pages will help you with the integration.
Video Tutorials
Discover our new video tutorials that will help you seamlessly connect to our APIs!
Discover essential information on the IT integration of our postal products and streamline your processes for greater efficiency!
Automatic completion of postal data
Best for:
- More user friendly than ever with fast and convenient address entry
- Accurate address data from initial contact
- Fewer returns thanks to correct postal data
- Simplified generation of routing codes with DHL-compliant data
Best for:
- Creating labels for international mail, lightweight items and merchandise
- European Business Customers sending worldwide
Notifications
Deutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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
Deutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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
Deutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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
Deutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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
Deutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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 SubscriptionDeutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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 SubscriptionDeutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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 SubscriptionDeutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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 SubscriptionDeutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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 SubscriptionDeutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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 SubscriptionDeutsche Post International (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post International (Post & Parcel Germany).
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
The INTERNETMARKE is the online-postage for mail products of Deutsche Post AG.
Best for:
Creation, purchase and payment of the following mail products:
- postcards and letter mails domestic (with additional services Registered Mail and Registered Mail with Return Slip)
- postcards and letter mails international (with additional service Registered Mail)
- domestic shipments of small goods
Notifications
Deutsche Post INTERNETMARKE (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post INTERNETMARKE (Post & Parcel Germany).
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
Deutsche Post INTERNETMARKE (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post INTERNETMARKE (Post & Parcel Germany).
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:
- Business customers of Deutsche Post AG
- Electronic order management of Deutsche Post AG's commercial and logistics processes (Mail)
Notifications
Guten Tag,
Ab sofort ist das AM.exchange Entwicklerhandbuch in der Version 5.4 verfügbar.
Wesentliche Änderung:
Änderung der Dialogpost und Postwurfspezial – Beispiele mit Freimachungsvermerk auf DV-Freimachung,
Anpassung der Beschreibung der asynchronen Datenübertragung im Hinblick auf die geplante, infrastrukturelle Änderung der Kommunikationsplattform und Aktualisierung der Produkttabellen.
Weitere Änderungen entnehmen Sie bitte der Änderungshistorie: bitte hier klicken
Beste Grüße
--
Kundenintegrationsservices / Customer Integration Services (CIS)
Abt. Kundenintegration Post
Deutsche Post AG
SNL IT P&P
Heinrich-Brüning-Str. 7
53113 Bonn
Deutschland
Telefon: +49 228 182-23500
Telefax: +49 228 182-23509
it-csp@deutschepost.de
cis-post_secure@deutschepost.de (für verschlüsselte Kommunikation)
Wenn Sie Daten verschlüsselt senden oder empfangen möchten, senden Sie Ihre Anfrage bitte signiert (S/MIME) an diese Adresse. Die Antwort erfolgt dann verschlüsselt an Ihre Absenderadresse. Falls keine Signatur vorliegt, fragen wir vor der Antwort nach. Auf unserem Keyserver finden Sie das Zertifikat für CIS-POST_SECURE@deutschepost.de
Servicezeiten: Mo - Fr von 8 - 16 Uhr
(außer an bundeseinheitlichen Feiertagen und Fronleichnam; Heiligabend und Silvester bis 12 Uhr)
DHL Group
Deutsche Post AG; Sitz Bonn; Registergericht Bonn; HRB 6792
Vorstand: Dr. Tobias Meyer, Vorsitzender; Oscar de Bok, Pablo Ciano, Nikola Hagleitner, Melanie Kreis, Dr. Thomas Ogilvie, John Pearson, Hendrik Venter
Aufsichtsratsvorsitzende: Dr. Katrin Suder
Dies ist eine Nachricht der Deutschen Post AG. Sie kann vertrauliche firmeninterne Informationen enthalten und ist ausschließlich für die oben adressierte Einzelperson bestimmt. Sind Sie nicht der beabsichtigte Empfänger, bitten wir Sie, den Sender zu informieren und die Nachricht sowie deren Anhänge zu löschen. Unzulässige Veröffentlichungen, Verwendungen, Verbreitung, Weiterleitung sowie das Drucken oder Kopieren dieser E-Mail und ihrer verknüpften Anhänge sind strikt untersagt.
Sie erhalten diese Nachricht, weil Sie Benachrichtigungen im DHL API Developer Portal abonniert haben. Wenn Sie die Benachrichtigungen abbestellen möchten, klicken Sie hier: Cancel Subscription
Guten Tag,
Ab sofort ist das AM.exchange Entwicklerhandbuch in der Version 5.3.3 verfügbar.
Wesentliche Änderung: Anpassung des Beispiels 009 (Neuanlage eines Einlieferungsauftrags für DV freigemachte elektronische Postzustellungsaufträge (ePZA) verschiedene Formate) und Aktualisierung der Produkttabellen.
Weitere Änderungen entnehmen Sie bitte der Änderungshistorie.
Beste Grüße
--
Kundenintegrationsservices / Customer Integration Services (CIS)
Abt. 1110 Kundenintegration Post
Deutsche Post AG
SNL IT P&P
64276 Darmstadt
Deutschland
Telefon: +49 228 182-23500
Telefax: +49 228 182-23509
it-csp@deutschepost.de
Servicezeiten: Mo - Fr von 8 - 16 Uhr
(außer an bundeseinheitlichen Feiertagen und Fronleichnam; Heiligabend und Silvester bis 12 Uhr)
This API is used for dispatching Dialogue Marketing print mailings.
- Calculate and optimize prices
- Create shipping documents
- Franking
- Place and change your order
- Use an easy way for dispatch preparation in your software
Notifications
Deutsche Post Print-Mailing Dispatch Preparation (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post Print-Mailing Dispatch Preparation (Post & Parcel Germany);
- Releasenotes: 2024-12-17 Price and GTC update for 2025
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
Deutsche Post Print-Mailing Dispatch Preparation (Post & Parcel Germany)
There have been content updates on the API Page Deutsche Post Print-Mailing Dispatch Preparation (Post & Parcel Germany):
- Release Notes: 2024-08-15 POSTAKTUELL - Change in bundle production according to delivery districts
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
Deutsche Post Print-Mailing Dispatch Preparation (Post & Parcel Germany)
Am 31.07.2024 zwischen 09 und 11 Uhr finden geplante Wartungsarbeiten für die Print-Mailing APIs (Versandvorbereitung und Zielgruppenplanung) statt.
In diesem Zeitraum kann es zu Einschränkungen bei der Nutzung der jeweiligen Applikation kommen.
Wir danken für Ihr Verständnis.
Mit freundlichen Grüße,
Ihr 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
This API is used for planning Dialogue Marketing print mailings.
- Plan new target groups and
- Select target areas.
- Get possible options for your print mailing directly and
- Receive relevant recipient data for the dispatch preparation.
Notifications
Deutsche Post Print-Mailing Targeting (Post & Parcel Germany)
Am 31.07.2024 zwischen 09 und 11 Uhr finden geplante Wartungsarbeiten für die Print-Mailing APIs (Versandvorbereitung und Zielgruppenplanung) statt.
In diesem Zeitraum kann es zu Einschränkungen bei der Nutzung der jeweiligen Applikation kommen.
Wir danken für Ihr Verständnis.
Mit freundlichen Grüße,
Ihr 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
POST & PARCEL GERMANY: For Business Customers of Parcel Germany.
Best for:
- Place free or chargeable pick-up orders via web service
- Query the agreed pickup locations assigned to the user
- Query details and status of a pickup
Best for:
- Validate postnumbers to ensure deliverability of shipments to the corresponding person at Packstation parcel lockers.
Notifications
Liebe Entwickler:innen,
heute möchten wir Sie darüber informieren, dass die Paket DE Postnummern API ab sofort um dedizierte Fehlerdetails erweitert wurde.
In der Response sind nun Details enthalten, warum der Abgleich mit unseren Packstations-Daten fehlgeschlagen ist (Postnummer falsch oder nicht freigeschaltet, oder abweichender Name).
Auf Basis dieser Details kann dem User bei der Eingabe der Packstationsadresse in Ihrem Checkout-Prozess eine spezifischere Fehlermeldung ausgegeben werden (Beispiel: die Postnummer ist korrekt, aber der Name weicht ab).
Alle Informationen über die Änderung entnehmen Sie der API Dokumentation der Postnummern API unter https://developer.dhl.com/api-reference/dhl-paket-de-postnummern-post-paket-deutschland
Mit freundlichen Grüßen
Ihr Team Group API Developer Portal Post & Paket
---------------
Dear developer,
Today we would like to inform you that the Parcel DE Postnumbers API has been extended to include dedicated error details.
The response now contains more specific details, if the comparison with our Packstation data failed (incorrect postal number or not activated, or different name).
Based on these details, a more specific error message can be displayed to the user when entering the Packstation address in your checkout process (example: the postal number is correct, but the name is different).
All information about the change can be found in the API documentation of the postal number API https://developer.dhl.com/api-reference/parcel-de-postnumber-post-parcel-germany?lang=en
Sincerely,
Your DHL team
Best for:
- Creation of return labels to be used by end customers
- Returns sender countries: bel, bgr, dnk, deu, est, fin, fra, grc, gbr, irl, ita, hrv, lva, ltu, lux, mlt, nld, nor, aut, pol, prt, rou, swe, che, svk, svn, esp, cze, hun, cyp
- Determination of receiver configuration for your account
Notifications
Sehr geehrte Nutzer der Retoure API (cig.dhl.de),
wir möchten Sie darüber informieren, dass die alte Version der Retoure API (unter cig.dhl.de) ab dem 31. Mai 2026 nicht mehr unterstützt wird.
Sollten Sie die genannte API direkt an Ihr System angebunden haben, empfehlen wir Ihnen, schnellstmöglich auf die neue DHL Paket DE Retoure API (unter api-eu.dhl.com) umzustellen.
Die Vorteile der neuen DHL Paket DE Retoure API auf einen Blick:
- Sichere Authentifizierungsmethode (OAuth2).
- Harmonisierung der Request- und Response-Strukturen, um die Nutzung zu optimieren.
- Verfügbare Retourenstandorte für Ihr Konto abrufen über den neuen Service /locations.
- Antwort auf internationale Rücksendungen einschließlich internationaler Sendungsnummern.
- Alle Änderungen können in den Release Notes der API Referenz Dokumentation eingesehen werden.
Falls Sie eine Softwarelösung zur Beauftragung von Sendungen nutzen (z. B. JTL, Gambio oder Dreamrobot), setzen Sie sich bitte unverzüglich mit dem Software-Anbieter in Verbindung, um noch rechtzeitig vor dem Abschalttermin Ende Mai 2026 auf eine neue Version zu wechseln.
Bei Fragen zur Umstellung auf die DHL Paket DE Retoure API können Sie uns jederzeit über das Group API Developer Portal Help Center kontaktieren.
Viele Grüße
Ihr DHL Team
--------------
Dear Users of the Returns API (cig.dhl.de),
We would like to inform you that the old version of the Returns API (under cig.dhl.de) will no longer be supported as of May 31, 2026.
If you have integrated the mentioned API directly into your system, we recommend that you transition to the new DHL Parcel DE Returns API (under api-eu.dhl.com) as soon as possible.
The benefits of the new DHL Parcel DE Returns API at a glance:
- Secure authentication method (OAuth2).
- Harmonization of request and response structures to optimize usage.
- Retrieve available return locations for your account through the new service /locations.
- Response for international returns, including international shipping numbers.
- All changes can be viewed in the release notes of the API reference documentation.
If you are using a software solution for dispatching shipments, such as JTL, Gambio, Dreamrobot, etc., please contact the manufacturer immediately to switch to a new version in time before the shutdown date at the end of May 2026.
You can contact us anytime with questions regarding the migration to the DHL Paket DE Returns API via the DHL API Developer Portal Help Center.
Kind regards
Your DHL team
Guten Tag,
die Sandbox Systeme arbeiten wieder im vollen Funktionsumfang.
Ihr Entwicklerportal Team
.....
Dear developers,
the sandbox systems are working again.
your devloperportal team
Sehr geehrte Entwickler,
aktuell liegt eine Störung der Sandbox Umgebung vor. Betroffen sind die Sandbox der Authentication- und der Versenden-API.
Wir arbeiten mit Hochdruck an der Behebung der Störung und werden Sie über diesen Kanal informieren, sobald diese behoben ist.
Ihr Entwicklerportal Team
Dear developers,
We are currently experiencing service interruptions if you use Sandbox environment of Authentication- and Shipping API.
We are working to resolve this issue and apologize for any inconvenience.
your devloperportal team
Sehr geehrte Entwickler,
zurzeit treten Unterbrechungen des Services auf, sofern sie die Authentifizierung über OAuth nutzen. Wir arbeiten mit Hochdruck an der Behebung und bedauern die Unannehmlichkeiten.
Ihr Entwicklerportal Team
Dear developers,
We are currently experiencing service interruptions if you use OAuth authentication. We are working to resolve this issue and apologize for any inconvenience.
your devloperportal team
Liebe Entwickler:innen,
wir möchten Sie über eine Änderung der DHL Paket DE Retoure API informieren:
Ab Ende September 2024 kann der QR-Code einer Mobilen Retoure per Deeplink in die Post & DHL App geladen werden. Damit haben Nutzer:innen eine einfache Möglichkeit, eine Mobile Retoure an einer Lean Packstation zu verwenden.
Dafür wird die Webservice Antwort der Retoure API am 26.9.24 um das Attribut „qrLink“ erweitert.
Wir informieren Sie hiermit frühzeitig über diese abwärtskompatible Änderung, sodass Sie Ihre Prozesse anpassen können.
Wir wünschen Ihnen weiterhin viel Erfolg mit unseren APIs und danken Ihnen noch einmal herzlich für Ihre Unterstützung!
Mit freundlichen Grüßen
Ihr Team Group API Developer Portal Post & Paket
---
Dear Developers,
We would like to inform you about an important change of our DHL Parcel DE Returns API:
From the end of September 2024, the QR code of a mobile return can be loaded into the Post & DHL app via deeplink. This gives users an easy way to use a mobile return at a Lean Packstation.
The “qrLink” attribute will be added to the web service response of the Returns API on 26.9.24.
We are hereby informing you about this downward-compatible change so that you can adapt your processes.
Sincerely
Your developer portal Post & Parcel team
Best for:
- Business customers of Post & Parcel Germany
- Create and manage shipment labes for domestic and international Parcels
Notifications
Sehr geehrte Nutzer der Paket DE Versenden API,
Am kommenden Donnerstag, den 09.10.2025 werden nach 22 Uhr technische Wartungsarbeiten an der Paket DE Versenden API durchgeführt. Während dieser Arbeiten wird es zu einer Downtime von ca. 60 Minuten kommen.
Wir möchten Sie darüber informieren, dass zukünftige Informationen zu Wartungsfenstern und Störungen ab sofort über die folgende Website bereitgestellt werden: https://post-paket-deutschland.status.api.dhl.com/ .
Bitte abonnieren Sie den Status-Feed, um stets auf dem neuesten Stand zu bleiben und keine wichtigen Updates zu verpassen.
Viele Grüße
Ihr DHL Team
----
Dear Users of the Parcel DE Shipping API,
On Thursday, October 9th 2025, we will carry out technical maintenance starting at 10PM. There will be a downtime of approx. 60 minutes of the Parcel DE Shipping API.
We would like to inform you that future information regarding maintenance windows and disruptions will now be provided through the following website: https://post-paket-deutschland.status.api.dhl.com/ .
Please subscribe to the status feed to stay updated and not miss any important announcements.
Kind regards
Your DHL team
Sehr geehrte Nutzer der Geschäftskundenversand-API,
wir möchten Sie darüber informieren, dass die alte Version 3 der SOAP API Geschäftskundenversand-API ab dem 31. Mai 2026 nicht mehr unterstützt wird.
Falls Sie noch diese veraltete Schnittstelle nutzen, ist eine Umstellung auf die neue REST-API DHL Paket DE Versenden V2 erforderlich.
Wir empfehlen Ihnen, möglichst noch vor dem Weihnachtsgeschäft 2025 auf die neue REST-API umzustellen, um sofort von den Vorteilen dieser schnelleren, stabilen und sicheren Anbindung (Nutzung des OAuth-2.0-Standards) zu profitieren.
Sollten Sie eine Softwarelösung (z.B. ein DHL Partnersystem) zur Beauftragung von Sendungen nutzen, setzen Sie sich bitte mit dem Hersteller in Verbindung, um rechtzeitig vor dem Abschalttermin auf eine neue Version zu wechseln.
Sollten Sie die API direkt an Ihr System angebunden haben, ist es unbedingt erforderlich, dass Sie die veraltete Version Geschäftskundenversand SOAP API v3 auf die neue REST-API DHL Paket DE Versenden V2 umstellen. Diese ist verfügbar unter https://developer.dhl.com/api-reference/parcel-de-shipping-post-parcel-germany-v2. Hier erhalten Sie auch weitere hilfreiche Informationen für Ihren Umstieg.
Bei Fragen zur Umstellung können Sie uns jederzeit über das Group API Developer Portal Help Center kontaktieren. Als eingeloggter User können Sie dort außerdem ein Ticket erstellen, um Unterstützung zu erhalten.
Zudem möchten wir Sie über folgende Anpassung informieren:
Am 01.01.2025 wurde das neue Produkt DHL Kleinpaket eingeführt, welches das bisherige Produkt Warenpost abgelöst hat. Bislang hat unser System eine automatische Umwandlung des veralteten Produktkürzels für Warenpost in das Produkt DHL Kleinpaket vorgenommen. Dieser Workaround wird aus technischen Gründen zum 31.05.2026 deaktiviert.
Falls Sie noch das veraltete Produktkürzels für Warenpost nutzen, bitten wir Sie, möglichst zeitnah eine Umstellung auf das neue Produkt DHL Kleinpaket vorzunehmen. Bitte ersetzen Sie dazu in Ihrer Anbindung das Kürzel „V62WP“ für die Warenpost durch das Kürzel „V62KP“ für das DHL Kleinpaket.
Sollten Sie eine Softwarelösung zur Beauftragung von Sendungen nutzen, setzen Sie sich bitte mit dem Hersteller in Verbindung, um rechtzeitig die Umstellung vorzunehmen.
Viele Grüße
Ihr DHL Team
--------------
Dear users of the Business Customer Shipping API,
We would like to inform you that the old version 3 of the SOAP Business Customer Shipping API will no longer be supported as of May 31, 2026.
If you are still using this outdated interface, a migration to the new REST API DHL Parcel DE Shipping V2 is required.
We recommend switching to the new REST API before the 2025 holiday season to immediately benefit from the advantages of this faster, more stable, and secure connection (using the OAuth 2.0 standard).
If you are using a software solution (e.g., a DHL Partner System) to dispatch shipments, please contact your software provider to ensure you switch to a new version in time before the shutdown date.
If you have integrated the API directly into your system, it is essential that you migrate from the outdated SOAP API v3 to the new REST API DHL Paket DE Shipping V2. It is available at https://developer.dhl.com/api-reference/parcel-de-shipping-post-parcel-germany-v2?lang=en#get-started-section/. Here you will also find further helpful information to support your migration.
If you have any questions regarding the migration, you can contact us at any time via the Group API Developer Portal Help Center. As a logged-in user, you can also create a ticket there to receive support.
We would also like to inform you about the following update:
On January 1, 2025, the new product DHL Kleinpaket was introduced, replacing the previous Warenpost product. Until now, our system has automatically converted the outdated product code for Warenpost to DHL Kleinpaket. For technical reasons, this workaround will be deactivated as of May 31, 2026.
If you are still using the outdated product code for Warenpost, we kindly ask you to switch to the new DHL Kleinpaket product as soon as possible.
Please replace the code “V62WP” (Warenpost) with “V62KP” (DHL Kleinpaket) in your integration.
If you are using a software solution to dispatch shipments, please contact the provider to ensure the switch is made in time.
Kind regards
Your DHL team
Sehr geehrte Nutzer der Paket DE Versenden API,
Am kommenden Freitag, den 3.10.2025 werden zwischen 11 Uhr bis 15 Uhr technische Wartungsarbeiten an der Paket DE Versenden API durchgeführt. Während dieser Arbeiten wird es zu einer kurzen Downtime von ca. 30 Minuten kommen.
Wir möchten Sie darüber informieren, dass zukünftige Informationen zu Wartungsfenstern und Störungen ab sofort über die folgende Website bereitgestellt werden: https://post-paket-deutschland.status.api.dhl.com/ .
Bitte abonnieren Sie den Status-Feed, um stets auf dem neuesten Stand zu bleiben und keine wichtigen Updates zu verpassen.
Viele Grüße
Ihr DHL Team
-------------
Dear Users of the Parcel DE Shipping API,
On Friday, October 3rd 2025, we will carry out technical maintenance between 11AM and 3PM. There will be a short downtime of 30min of the Parcel DE Shipping API.
We would like to inform you that future information regarding maintenance windows and disruptions will now be provided through the following website: https://post-paket-deutschland.status.api.dhl.com/ .
Please subscribe to the status feed to stay updated and not miss any important announcements.
Kind regards
Your DHL team
Sehr geehrte Nutzer der Paket DE Versenden API,
Wiederaufnahme des Versands in die USA und nach Puerto Rico
Ab sofort ist es wieder möglich, Label für den Versand in die USA und nach Puerto Rico zu erzeugen. Dabei sind zwingend folgende Anpassungen zu beachten:
- Der Versand ist ausschließlich mit unserem Produkt „DHL Paket International“ (V01PAK) möglich. Der USA-Versand mit dem Produkt “Warenpost International” (V66WPI) ist weiterhin nicht möglich.
- Für Sendungen unter einem Zollwert von bis zu 800 US-Dollar bzw. 680 Euro muss zwingend der Service PDDP (postalDeliveryDutyPaid) hinzugebucht werden. Ansonsten ist keine Zollabwicklung für diese Sendungen möglich und die Sendungen werden an den Versender retourniert. Für Sendungen oberhalb dieses Warenwertes ist eine Buchung von PDDP nicht vorgesehen. Wird der Service dennoch für diese Sendungen gebucht, werden diese ebenfalls an den Versender retourniert.
- Für Adressen in den USA muss über alle Buchungskanäle der Bundesstaat im Adresselement „state“ übergeben werden.
- Zusätzlich zu den bisher verpflichtenden Angaben für Warenpositionen, sind für Sendungen in die USA zwingend Angaben zur Zolltarifnummer (hsCode) und zum Ursprungsland (countryOfOrigin) erforderlich.
- Die Angabe aller Warenwerte (itemValue) und der Versandkosten (postalCharges) für Zollzwecke muss zwingend in Euro (EUR) oder US-Dollar (USD) erfolgen. Andere Währungen (currency) sind nicht zulässig.
Weitere Hintergrundinformationen sind auf dieser Webseite und in dieser Kundeninformation zusammengefasst.
Viele Grüße
Ihr DHL Team
--------------
Dear Users of the Parcel DE Shipping API,
Relaunch shipping to the USA and Puerto Rico
Effective immediately, it is possible again to generate labels for shipments to the USA and Puerto Rico. Please note that the following adjustments are mandatory:
- Shipping is only possible via our product "DHL Paket International" (V53WPAK). We still do not offer shipping via “Warenpost International” (V66WPI).
- For shipments with a customs value of up to or at $800 or €680, our service “PDDP” (postalDeliveryDutyPaid) must be used. Otherwise, customs clearance for these shipments will not be possible, and the shipments will be returned to the sender. For shipments exceeding this merchandise value, booking PDDP is not intended. If the service is nevertheless booked for such shipments, they will also be returned to the sender.
- For addresses in the USA, the state must be passed across all booking channels in the address element “state”.
- In addition to the previously required information for item positions, it is now mandatory to provide the customs tariff number (hsCode) and the country of origin (countryOfOrigin) for all shipments to the USA.
- All goods values (itemValue) as well as shipping costs (postalCharges) for customs purposes, must be stated in euros (EUR) or US dollars (USD). Any other currencies are not permitted.
Further background information is summarized on this website and in this customer information.
Kind regards
Your DHL team
For english see below.
Aufgrund der aktuellen Entwicklungen in den USA ist der Warenversand ab dem 26. August 2025 nur noch mit DHL Express möglich. Alle USA-Sendungen, die uns ab diesem Tag übergeben werden, müssen wir an den Versender retournieren. Aus technischen Gründen kann die Sperrung der Sendungsbuchung in der Funktion „Versenden“ erst am Mittwoch, den 27. August, nachmittags erfolgen. Wir bitten Sie, Ihre Beauftragungs- und Versandprozesse kurzfristig anzupassen. Weitere Hintergrundinformationen finden Sie in dem vorherigen Kundenanschreiben.
Viele Grüße
Ihr Team DHL
----
Due to current developments in the USA, shipping of goods will only be possible with DHL Express starting August 26, 2025. All shipments to the USA that are handed over to us after this date will need to be returned to the sender. For technical reasons, the blocking of shipment bookings in the function Ship can only take place on Wednesday, August 27, in the afternoon. We kindly ask you to adjust your ordering and shipping processes accordingly. Further background information can be found in the first notification.
Kind regards
Your Team DHL
Best for:
With the DHL shipment tracking API pivate and business customers can query the shipment status and history of shipments at any time.
Notifications
DE
Am Sonntag, den 18.05.2025 wird zwischen 10 und 13 Uhr eine neue Version der DHL Sendungsverfolgung API ausgerollt. Während der Arbeiten kann es zu kurzzeitigen Einschränkungen der API kommen.
EN
On Sunday, May 18th 2025 a new version of the DHL shipment tracking API will be rolled out between 10 am and 1 pm. During this time, there may be temporary limitations in using the API.
DE
Am Sonntag, den 18.05.2025 wird zwischen 10 und 13 Uhr eine neue Version der DHL Sendungsverfolgung API ausgerollt. Während der Arbeiten kann es zu kurzzeitigen Einschränkungen der API kommen.
EN
On Sunday, May 18th 2025 a new version of the DHL shipment tracking API will be rolled out between 10 am and 1 pm. During this time, there may be temporary limitations in using the API.
Verfolgen Paket & Waren: Am Sonntag, den 27.04.2025, wird zwischen 10 und 13 Uhr eine neue Version der Funktion ausgerollt. Während der Arbeiten kann es zu kurzzeitigen Einschränkungen bei der Nutzung der Funktion und der API Sendungsverfolgung kommen.
Track Parcel & Goods: On Sunday, April 27th 2025, a new version of the function will be rolled out between 10 am and 1 pm. During this time, there may be temporary limitations in using the function and the Track Parcel API.
Liebe Kund:innen und Entwickler:innen,
wir möchten Sie über Neuerungen zur Nutzung der API Sendungsverfolgung Geschäftskunden (GK) informieren, die ab heute, 13.06.2024 gelten.
Wer ist betroffen?
Alle Kund:innen, die die API Sendungsverfolgung GK verwenden (DASS-B Nutzer).
Was ändert sich?
Die Authentifizierung für die Nutzung der API Sendungsverfolgung GK erfolgt nun über das Post & DHL Geschäftskundenportal (GKP). Bisher verwendete Zugangsdaten zur Nutzung der API Sendungsverfolgung GK wurden in einen „Übergangsbenutzer API Sendungsverfolgung“ migriert. Alle bisherigen Berechtigungen sind weiterhin vorhanden.
Was ist der Übergangsbenutzer?
Der Übergangsbenutzer stellt sicher, dass bisher genutzte Zugangsdaten für max. ein Jahr weiter verwendet werden können.
Was müssen Sie veranlassen?
- Es besteht kein akuter Handlungsbedarf auf Ihrer Seite. Für alle zwischen Januar und Juni 2024 aktiven Nutzer der API Sendungsverfolgung GK wurde durch Einrichten des Übergangsbenutzers sichergestellt, dass die API bis auf Weiteres mit den aktuell verwendeten Zugangsdaten genutzt werden kann.
- Bis spätestens Ende Mai 2025 müssen Sie den Übergangsbenutzers (alte zt-Kennung) durch einen GKP Benutzer austauschen. Wir empfehlen hierfür die Einrichtung eines GKP Benutzers mit dem Typ “Systembenutzer” zur Nutzung ausschließlich in technischen Schnittstellen. Der neue GKP Benutzer muss die Berechtigung für die Funktion „Verfolgen Paket & Waren“ erhalten.
Was können Sie tun, wenn der Zugang zur API Sendungsverfolgung nicht funktioniert?
Im Einzelfall kann es z. B. aufgrund veralteter Daten (abgelaufene Nummernkreis o. ä.) vorkommen, dass kein Übergangsbenutzer angelegt werden konnte. In diesem Fall müssen Sie aktiv einen Benutzer im GKP mit den erforderlichen Berechtigungen anlegen und die Zugangsdaten für die Nutzung in allen API-Aufrufen hinterlegen.
Können die Berechtigungen des Übergangsbenutzers verändert werden?
Es kann vorkommen, dass einzelne Berechtigungen nicht aus dem Altsystem migriert wurden und Ihnen dadurch nur noch öffentliche Sendungsdaten (keine datenschutzrelevanten Daten) angezeigt werden.
Für diesen Fall und auch bei allen sonstigen Fällen fehlender Berechtigungen gilt, dass Sie aktiv einen neuen Benutzer im GKP anlegen müssen. Die GKP Zugangsdaten des neuen Benutzers müssen in allen Aufrufen der API Sendungsverfolgung GK mitgegeben werden.
Kann ich das Passwort für den Übergangsbenutzer ändern?
Für den Übergangsbenutzer ist kein Passwort-Rücksetzung möglich. In diesem Fall muss direkt ein neuer GKP Benutzer angelegt werden. Der Übergangsbenutzer kann ab diesem Zeitpunkt nicht weiter verwendet werden.
Bei Fragen zu Berechtigungen wenden Sie sich bitte an Ihre vertriebliche Ansprechperson.
Bei technischen Fragen erstellen Sie bitte ein Ticket im Group API Developer Portal.
Mit freundlichen Grüßen
Ihr Team Group API Developer Portal
-----
Dear customers and developers,
we would like to inform you about changes to the use of the API Shipment Tracking Business Customers (BC), which apply from today, June 13, 2024.
Who is affected?
All customers who use the API Shipment Tracking BC (DASS-B users).
What is changing?
Authentication for the use of the API Shipment Tracking BC is now carried out via the Post & DHL Business Customer Portal (GKP). Previously used access data for using the API Shipment Tracking BC has been migrated to a “Transition user API Shipment Tracking”. All previous authorizations are still available.
What is the transition user?
The transition user ensures that previously used access data still can be used for a maximum of one year.
What do you need to do?
There is no acute need for action on your part. For all users of the API Shipment Tracking BC active between January and June 2024, setting up the transition user ensures that the API can be used with the currently used access data until further notice.
However, you must replace the transitional user (old zt user) with a GKP user by the end of May 2025 at the latest. We recommend setting up a GKP user with the type “system user” for use exclusively in technical interfaces. The new GKP user must have authorization for the “Track Parcels & Goods” function.
What can you do if access to the API Shipment Tracking does not work?
In individual cases, it may not be possible to create a transition user, e.g. due to outdated data (expired number range or similar). In this case, you must actively create a user in the GKP with the required authorizations and store the access data for use in all API calls.
Can the transition user's authorizations be changed?
It is possible that individual authorizations have not been migrated from the old system and therefore only public shipment data (not data relevant to data protection) is displayed.
In this case and in all other cases of missing authorizations, you must actively create a new user in GKP. The GKP access data of the new user must be entered in all calls to the API Shipment Tracking BC.
Can I change the password for the transition user?
It is not possible to reset the password for the transition user. In this case, a new GKP user must be created directly. The transition user can no longer be used from this point onwards.
If you have any questions about authorizations, please get in touch with your sales contact person.
If you have any technical questions, please create a ticket in the Group API Developer Portal.
Yours sincerely
Your team Group API Developer Portal
Best for:
- Finding all DHL pick-up and drop-off points to send and receive packages
- Integrating multiple types of Deutsche Post DHL locations
- Locations in Germany and many countries worldwide
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
Purpose
Calculates the duties, taxes and governmental fees for any international shipment, taking into consideration country de minimis values and preferential tariff rates that may apply. The Duty and Tax Calculator API does not provide shipping rates, but instead uses the shipping rate charged to the consignee as an input.
Works with
Any carrier, not just DHL, and have a Worldwide scope (if you are a DHL Express customer, please use the DHL Express - MyDHL API)
Free 30-day trial
Get immediate access and 30 days of free calculations (API calls).
Looking for other Post and Parcel Germany APIs?
You can also find the documentation for older Post & DHL APIs here in the Group API Developer Portal (GDP). Access to this can be provided to you free of charge. Please register for GDP and then contact our support team.
On this info page you will find brief instructions and FAQs after switching to the new Group API Developer Portal in 2023.
API guide - Finding the right API for your business needs
This list will help you to find out which API you should use for which Post & Paket Deutschland products.
You will also see other APIs that can support your business processes.
| Function | API | Available Products | National | International | |||||
|---|---|---|---|---|---|---|---|---|---|
| Authentication | Authentication API | Authentication API (OAuth2) for Post & Post & Parcel business customer APIs Ongoing extension of all Post & Parcel Germany APIs | |||||||
| Preparation | Location Finder - Unified | Finding all DHL pick-up and drop-off points to send and receive packages worldwide |  | | |||||
| DATAFACTORY AUTOCOMPLETE 2.0 | Automatic completion of postal data | | |||||||
| DHL Parcel DE Postnumber API | Validation of german postnumbers | | |||||||
| DHL Parcel DE MyAccount API (Invitation Only) | Query of business customer contract configurations | ||||||||
| Shipping | DHL Parcel DE Shipping API | DHL Paket (national/international) DHL Kleinpaket (national) DHL Europaket Warenpost (international) | | | |||||
| DHL Parcel DE Returns API | DHL Retoure (national/international) | | | ||||||
| Deutsche Post INTERNETMARKE | Postcards and Letters (national/international) Warensendungen national | | | ||||||
| Deutsche Post International (DPI) API | Packet-Tracked, Packet-Plus, Packet-Standard, Packet-Return Business Mail (Standard/Priority), Letter Business Mail Registered, Letter Plus | | |||||||
| Pickup | DHL Parcel DE Pickup API | Pickup DHL Paket (national/international) shipments | | ||||||
| Tracking | DHL Parcel DE Tracking API | Access to the current shipment status with business information DHL Paket (national/international), DHL Retoure (national/international), DHL Kleinpaket (national), Warenpost (international), DHL 2-Mann-Handling shipments | | | |||||
| Shipment Tracking - Unified | Access to the current shipment status with public information Integration of all types of DHL Group shipments | | | ||||||
For more in-depth questions, you can also contact our support team.
Here are some tips that'll show you, how to navigate through the Developer Portal to find the API, fitting best to your business.
Browse API catalog by 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 servs lies, please check the Division box to filter the APIs (e.g. Post & Parcel Germany). Another common way is to filter APIs by Service Type (e.g. Location / Shipping / Pickup / 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. After clicking on the API teaser, the API reference page opens, where you can find detaild information about the API under Get Started/Scope
The API Guide helps you to find out which API you should use for which Post & Parcel Germany products.
With the modernization of our API landscape, we are replacing the previous Basic Authentication with an Authentication API that supports OAuth 2.0.
We have listed the advantages of using the new authentication API for you at https://developer.dhl.com/post-paket-deutschland-authentication-api-vorteile-und-verwendung
In case of IT-service and API incidents you get proactively informed by Post & Parcel Germany. All you have to do is: Visit the IT Status Dashboard under https://post-paket-deutschland.status.api.dhl.com/ and register for all services you'd like to get informed about.
You have provided a Postman test collection, but I don't know how to use it. Please read our step-by-step instructions at: https://developer.dhl.com/howto-use-postman