Post & Parcel Germany

Deutsche Post and DHL APIs for developers

 

Mit den APIs von Deutsche Post & DHL können Sie schnell und einfach unsere Lösungen für Logistik und Dialogmarketing nutzen und Ihre Webservices um nützliche Informationen erweitern. Über unsere APIs können Sie Versand-Label und Internet-Briefmarken erstellen, den Sendungsstatus abfragen oder unsere Services in Ihren Online-Shop integrieren.

Post APIs

Übersichtsseite für die  IT-Anbindung von Briefprodukten der Deutschen Post (produktübergreifend)

|| Overview page for IT-specific information for using and connecting to Deutsche Post letter products

 

darunter Produkte wie || including products as

  • Auftragsmanagement / Order management APIs
  • Presse / press products
  • Deutsche Post Internetmarke API
  • produktspezifische Preislisten || product specific price lists
  • produktspezifische Video-Tutorials

sowie || as well as

  • Links zu weiterführenden produkt- und fachspezifischen Dokumenten || Links to additional product documentations and websites

 

Geeignet für || suitable for:

  • Geschäftskunden der Deutsche Post AG
  • Softwarepartner / Third Party Vendors

direct contact:  it-csp@deutschepost.de

Übersichtsseite für die  IT-Anbindung von Briefprodukten der Deutschen Post (produktübergreifend)

|| Overview page for IT-specific information for using and connecting to Deutsche Post letter products

darunter Produkte wie || including products as

  • Auftragsmanagement / Order management APIs
  • Presse / press products
  • Deutsche Post Internetmarke API
  • produktspezifische Preislisten || product specific price lists
  • produktspezifische Video-Tutorials

sowie || as well as

  • Links zu weiterführenden produkt- und fachspezifischen Dokumenten || Links to additional product documentations and websites

 

Geeignet für || suitable for:

  • Geschäftskunden der Deutsche Post AG
  • Softwarepartner / Third Party Vendors

direct contact:  it-csp@deutschepost.de

Best for:

  • German Business Customers
  • AM.numbers is a supplementary service, which complements the creation of orders via AM.exchange.
  • The API provides required NVE numbers that will then be entered when placing an order in AM.exchange.

Best for:

  • Business customers of Deutsche Post AG
  • Electronic order management of Deutsche Post AG's commercial and logistics processes (Mail)

Notifications

02-04-2025 08:13
TEST - Deutsche Post Auftragsmanagement - EHB 5.3.3 online

Guten Tag,

ab sofort ist das AM.exchange - Entwicklerhandbuch in der Version 5.3.3  verfügbar.

 

Wesentliche Änderung: Anpassung des Beispiels 009 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)

02-04-2025 07:43
TEST - Deutsche Post Auftragsmanagement - EHB 5.3.3 online

Guten Tag,

Ab sofort ist das AM.exchange Entwicklerhandbuch in der Version 5.3.3 verfügbar.

 

Wesentliche Änderung: Anpassung des Beispiels 009 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)

 

Parcel APIs
Early Access
Retouren Logo

API Typ: REST
Version 1.0

Open API Specification (10.04.2021)

API Provider: DHL Paket GmbH

 

The API Returns allows to order return labels for planned return shipments from your customers.

It thereby enables business customers of DHL to seamlessly implement the label creation process for return labels into their own workflows, for example integrated into their own website.

Best for:

  • Creation of return labels to be used by end customers
  • Returns sender countries: bgr, dnk, deu, est, fin, fra, grc, gbr, irl, ita, hrv, lva, ltu, lux, mlt, nld, aut, pol, prt, rou, swe, che, svk, svn, esp, cze, hun, cyp
  • Determination of receiver configurationfor your account

POST & PARCEL GERMANY: For partners or business customers of Parcel Germany, typically used by asian partners consolidating shipments into Germany.

CSE (Customer Shipping Event): Allows partners and business customers to push a notification event towards DHL. Typically used by first-mile shipping partner to notify DHL of successful handover.

Best for:

  • Business customers of Post & Parcel Germany
  • Create and manage shipment labes for domestic and international Parcels

Notifications

06-05-2025 11:21
Parcel DE Shipping (Post & Parcel Germany) - API Page Update

Parcel DE Shipping (Post & Parcel Germany)

There have been content updates on the API Page Parcel DE Shipping (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

06-05-2025 11:02
Letzte Erinnerung an die Abschaltung der Geschäftskundenversand SOAP API v2

Sehr geehrte Nutzer der Geschäftskundenversand SOAP API, 

wie bereits angekündigt wird die veraltete Geschäftskundenversand SOAP API v2 zum 31. Mai 2025 deaktiviert. 

Die Beauftragung von Sendungen über diese Schnittstelle ist somit in wenigen Wochen nicht mehr möglich! Dies ist die letzte Erinnerung an den dringend notwendigen Wechsel!

  • Sollten Sie eine Softwarelösung zur Beauftragung von Sendungen wie z.B. JTL oder Xentral nutzen, setzen Sie sich bitte unverzüglich mit dem Hersteller in Verbindung, um noch rechtzeitig vor dem Abschalttermin Ende Mai 2025 auf eine neue Version zu wechseln.
  • Sollten Sie die API direkt an Ihr System angebunden haben, ist es nun unbedingt erforderlich, dass Sie die veraltete Version Geschäftskundenversand SOAP API v2 auf die neue DHL Paket DE Versenden REST API umstellen. Diese ist unter DHL Paket DE Versenden REST API im Group API Developer Portal von DHL verfügbar. Hier finden Sie auch weitere hilfreiche Informationen für Ihren Umstieg.

Hinweis: Außerdem werden wir die Weiterentwicklung der Version v3 der Geschäftskundenversand SOAP API einstellen. Diese Version wird ein Jahr später, zum 31. Mai 2026, abgeschaltet.

Sie können uns jederzeit bei Fragen zur Migration auf die DHL Paket DE Versenden API über das DHL API Developer Portal Help Center kontaktieren.

Mit freundlichen Grüßen
Ihr DHL-Team

Final reminder on the deactivation of Geschäftskundenversand (GKV) SOAP API v2

Dear user of DHL Parcel Shipping SOAP API, 

As previously announced, the deprecated Geschäftskundenversand (GKV) [Business Customer Shipping] SOAP API v2 will be deactivated on May 31, 2025

Therefore, shipment orders via this interface will no longer be possible in a few weeks! This is the final reminder for the urgently needed transition!

  • If you use a software solution to order shipments – such as JTL or Xentral – please contact the manufacturer to switch to a new version in time before the shutdown date at the end of May 2025.
  • If your systems are directly connected to the API and not via a third-party software, it is necessary for you to switch from the outdated version 2 of the Geschäftskundenversand (GKV) SOAP API to the new DHL Parcel DE Shipping RESTful API. Our REST API is available at DHL Parcel DE Shipping REST API in the DHL Group API Developer Portal. Here you will also find other helpful information for your transition.

Please note: We will also discontinue the development of version v3 of the Geschäftskundenversand (GKV) SOAP API. This API is scheduled to be decommissioned on May 31, 2026.

You can always contact us with questions about migration to the DHL Paket DE Shipping API via the DHL API Developer Portal Help Center.

Sincerely,
Your DHL team

06-05-2025 10:59
Letzte Erinnerung an die Abschaltung der Geschäftskundenversand SOAP API v2


Sehr geehrte Nutzer der Geschäftskundenversand SOAP API, 
wie bereits angekündigt wird die veraltete Geschäftskundenversand SOAP API v2 zum 31. Mai 2025 deaktiviert. 
Die Beauftragung von Sendungen über diese Schnittstelle ist somit in wenigen Wochen nicht mehr möglich! Dies ist die letzte Erinnerung an den dringend notwendigen Wechsel!
•    Sollten Sie eine Softwarelösung zur Beauftragung von Sendungen wie z.B. JTL oder Xentral nutzen, setzen Sie sich bitte unverzüglich mit dem Hersteller in Verbindung, um noch rechtzeitig vor dem Abschalttermin Ende Mai 2025 auf eine neue Version zu wechseln.
•    Sollten Sie die API direkt an Ihr System angebunden haben, ist es nun unbedingt erforderlich, dass Sie die veraltete Version Geschäftskundenversand SOAP API v2 auf die neue DHL Paket DE Versenden REST API umstellen. Diese ist unter DHL Paket DE Versenden REST API im Group API Developer Portal von DHL verfügbar. Hier finden Sie auch weitere hilfreiche Informationen für Ihren Umstieg.
Hinweis: Außerdem werden wir die Weiterentwicklung der Version v3 der Geschäftskundenversand SOAP API einstellen. Diese Version wird ein Jahr später, zum 31. Mai 2026, abgeschaltet.
Sie können uns jederzeit bei Fragen zur Migration auf die DHL Paket DE Versenden API über das DHL API Developer Portal Help Center kontaktieren.
Mit freundlichen Grüßen
Ihr DHL-Team

Final reminder on the deactivation of Geschäftskundenversand (GKV) SOAP API v2
Dear user of DHL Parcel Shipping SOAP API, 
As previously announced, the deprecated Geschäftskundenversand (GKV) [Business Customer Shipping] SOAP API v2 will be deactivated on May 31, 2025. 
Therefore, shipment orders via this interface will no longer be possible in a few weeks! This is the final reminder for the urgently needed transition!
•    If you use a software solution to order shipments – such as JTL or Xentral – please contact the manufacturer to switch to a new version in time before the shutdown date at the end of May 2025.
•    If your systems are directly connected to the API and not via a third-party software, it is necessary for you to switch from the outdated version 2 of the Geschäftskundenversand (GKV) SOAP API to the new DHL Parcel DE Shipping RESTful API. Our REST API is available at DHL Parcel DE Shipping REST API in the DHL Group API Developer Portal. Here you will also find other helpful information for your transition.
Please note: We will also discontinue the development of version v3 of the Geschäftskundenversand (GKV) SOAP API. This API is scheduled to be decommissioned on May 31, 2026.
You can always contact us with questions about migration to the DHL Paket DE Shipping API via the DHL API Developer Portal Help Center.
Sincerely,
Your DHL team    
 

06-05-2025 10:58
n

Parcel DE Shipping (Post & Parcel Germany)

There have been content updates on the API Page Parcel DE Shipping (Post & Parcel Germany).

You can have a detailed look at the changes by clicking the following link: Click here

Letzte Erinnerung an die Abschaltung der Geschäftskundenversand SOAP API v2

Sehr geehrte Nutzer der Geschäftskundenversand SOAP API, 

wie bereits angekündigt wird die veraltete Geschäftskundenversand SOAP API v2 zum 31. Mai 2025 deaktiviert. 

Die Beauftragung von Sendungen über diese Schnittstelle ist somit in wenigen Wochen nicht mehr möglich! Dies ist die letzte Erinnerung an den dringend notwendigen Wechsel!

  • Sollten Sie eine Softwarelösung zur Beauftragung von Sendungen wie z.B. JTL oder Xentral nutzen, setzen Sie sich bitte unverzüglich mit dem Hersteller in Verbindung, um noch rechtzeitig vor dem Abschalttermin Ende Mai 2025 auf eine neue Version zu wechseln.

Hinweis: Außerdem werden wir die Weiterentwicklung der Version v3 der Geschäftskundenversand SOAP API einstellen. Diese Version wird ein Jahr später, zum 31. Mai 2026, abgeschaltet.

Sie können uns jederzeit bei Fragen zur Migration auf die DHL Paket DE Versenden API über das DHL API Developer Portal Help Center kontaktieren.

Mit freundlichen Grüßen
Ihr DHL-Team

Final reminder on the deactivation of Geschäftskundenversand (GKV) SOAP API v2

Dear user of DHL Parcel Shipping SOAP API, 

As previously announced, the deprecated Geschäftskundenversand (GKV) [Business Customer Shipping] SOAP API v2 will be deactivated on May 31, 2025

Therefore, shipment orders via this interface will no longer be possible in a few weeks! This is the final reminder for the urgently needed transition!

  • If you use a software solution to order shipments – such as JTL or Xentral – please contact the manufacturer to switch to a new version in time before the shutdown date at the end of May 2025.
  • If your systems are directly connected to the API and not via a third-party software, it is necessary for you to switch from the outdated version 2 of the Geschäftskundenversand (GKV) SOAP API to the new DHL Parcel DE Shipping RESTful API. Our REST API is available at DHL Parcel DE Shipping REST API in the DHL Group API Developer Portal. Here you will also find other helpful information for your transition.

Please note: We will also discontinue the development of version v3 of the Geschäftskundenversand (GKV) SOAP API. This API is scheduled to be decommissioned on May 31, 2026.

You can always contact us with questions about migration to the DHL Paket DE Shipping API via the DHL API Developer Portal Help Center.

Sincerely,
Your DHL team

 

 

06-05-2025 10:55
Letzte Erinnerung an die Abschaltung der Geschäftskundenversand SOAP API v2

Sehr geehrte Nutzer der Geschäftskundenversand SOAP API, 

wie bereits angekündigt wird die veraltete Geschäftskundenversand SOAP API v2 zum 31. Mai 2025 deaktiviert. 

Die Beauftragung von Sendungen über diese Schnittstelle ist somit in wenigen Wochen nicht mehr möglich! Dies ist die letzte Erinnerung an den dringend notwendigen Wechsel!

  • Sollten Sie eine Softwarelösung zur Beauftragung von Sendungen wie z.B. JTL oder Xentral nutzen, setzen Sie sich bitte unverzüglich mit dem Hersteller in Verbindung, um noch rechtzeitig vor dem Abschalttermin Ende Mai 2025 auf eine neue Version zu wechseln.

Hinweis: Außerdem werden wir die Weiterentwicklung der Version v3 der Geschäftskundenversand SOAP API einstellen. Diese Version wird ein Jahr später, zum 31. Mai 2026, abgeschaltet.

Sie können uns jederzeit bei Fragen zur Migration auf die DHL Paket DE Versenden API über das DHL API Developer Portal Help Center kontaktieren.

Mit freundlichen Grüßen
Ihr DHL-Team

Final reminder on the deactivation of Geschäftskundenversand (GKV) SOAP API v2

Dear user of DHL Parcel Shipping SOAP API, 

As previously announced, the deprecated Geschäftskundenversand (GKV) [Business Customer Shipping] SOAP API v2 will be deactivated on May 31, 2025

Therefore, shipment orders via this interface will no longer be possible in a few weeks! This is the final reminder for the urgently needed transition!

  • If you use a software solution to order shipments – such as JTL or Xentral – please contact the manufacturer to switch to a new version in time before the shutdown date at the end of May 2025.
  • If your systems are directly connected to the API and not via a third-party software, it is necessary for you to switch from the outdated version 2 of the Geschäftskundenversand (GKV) SOAP API to the new DHL Parcel DE Shipping RESTful API. Our REST API is available at DHL Parcel DE Shipping REST API in the DHL Group API Developer Portal. Here you will also find other helpful information for your transition.

Please note: We will also discontinue the development of version v3 of the Geschäftskundenversand (GKV) SOAP API. This API is scheduled to be decommissioned on May 31, 2026.

You can always contact us with questions about migration to the DHL Paket DE Shipping API via the DHL API Developer Portal Help Center.

Sincerely,
Your DHL team

 

 

 

Group APIs

Looking for previous Post and DHL Germany APIs?

We are currently transfering the content of the old developer portal to this new environment.

Please refer to the "Post & DHL Entwicklerportal" for previous API specifications:

Go to Post & DHL Entwicklerportal

Do you have further questions? Please refer to the latest FAQs
I'm not sure which API to use?

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: 

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 / 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. After clicking on the API teaser, the API reference page opens, where you can find detaild information about the API under Get Started/Scope

 

 

What happens to Post and DHL Entwicklerportal?

In order to harmoize and modernize our API landscape for DP DHL overall, we are currently transferring the old Post and DHL Entwicklerportal APIs and funcionalities to the new Developer Portal.

Please refer to the information in the old developer portal, we are going to provide during 2023.

Test

  • Test einer
  • Liste

 

  1. Test einer
  2. Liste

Test eines Links

 

 



 

 

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 APIAvailable ProductsNationalInternational
Authentication Authentication API

Authentication API (OAuth2) for Post & Post & Parcel business customer APIs.

Ongoing extension of all Post & Parcel Germany APIs.

  
Preparation Location Finder - UnifiedFinding all DHL pick-up and drop-off points to send and receive packages worldwide.CheckCheck
DATAFACTORY AUTOCOMPLETE 2.0Automatic completion of postal data.Check 
DHL Parcel DE Postnumber APIValidation of german postnumbers.Check 
DHL Parcel DE MyAccount API (Invitation Only)Query of business customer contract configurations.  
Shipping DHL Parcel DE Shipping API

DHL Paket (national/international)

DHL Europaket

Warenpost (national/international)

CheckCheck
DHL Parcel DE Returns APIDHL Retoure (national/international)CheckCheck
Deutsche Post INTERNETMARKE

Postcards and Letters (national/international)

Bücher- und Warensendungen national

CheckCheck
Deutsche Post International (DPI) API

Packet-Tracked, Packet-Plus, Packet-Standard, Packet-Return

Business Mail (Standard/Priority), Letter Business Mail Registered, Letter Plus

 Check
Pickup DHL Parcel DE Pickup APIPickup DHL Paket (national/international) shipments.Check 
Tracking DHL Parcel DE Tracking API

Access to the current shipment status with business information.

DHL Paket (national/international), DHL Retoure (national/international), Warenpost (national/international), DHL 2-Mann-Handling Sendungen

CheckCheck
Shipment Tracking - Unified

Access to the current shipment status with public information.

Integration of all types of DHL Group shipments.

CheckCheck