Deutsche Post INTERNETMARKE (Post & Parcel Germany)
v 1.30
Division: Post & Parcel Germany, Post

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 
Used for: Shipping
Overview

The Deutsche Post INTERNETMARKE API enables the online purchase of INTERNETMARKEN with an individual postage cash account (Portokasse) to the end customer.

Integrate the INTERNETMARKE into your own shop management systems. Frank all your shipments promptly, quickly and directly from your own application.
 

Your advantages in overview:

  • Fast shipping directly from your system
  • Easy integration of the interface
  • Adaptability of the system to your needs
  • Printing via your label printer

In the following chapters we offer you:

Scope 

The Deutsche Post INTERNETMARKE API offers resources for:

  • Usermanagement / cash assigned payment (Portokasse) management
  • Internetmarken generation, purchase and reimbursement, and
  • the retrieval of print formats, usable graphic motifs and user-specific information.
  • You can obtain information on products and prices by integrating the Products API
     

Note:

When implementing the INTERNETMARKEN API, it makes sense to also integrate the Products API - this ensures the latest information on products and prices being always available without any further effort.

The Products API is an additional interface (ReST API) that allows you to easily retrieve the product codes and prices available or usable with Internetmarken. Access to the Products API is automatically enabled for all users of the INTERNETMARKE API; no additional activation process is required. 

Using the API

The Deutsche Post INTERNETMARKE API covers:

The AppResource provides functionalities for the purchase and management of INTERNETMARKEN:

  • Creation of Internet stamps for single or multiple shipments 
  • Provision of franking marks as PDF file or PNG graphics (in ZIP file) 
  • Automatic debiting of transaction costs from the assigned postage cash account
  • Providing previews of the franking mark as a PDF or PNG document 
  • Retrieval of information by using additional services (such as registered mail) for the purpose of creating a posting receipt or using a dispatch list 
  • Direct top-up of the (previously authenticated) postage cash account via direct debit ( in case of a valid SEPA mandate) 
  • Retrieval of public and user-specific graphic motifs, contract products and individual prices 
  • Refund of purchased but unused Internet stamps. 
     

The  UserResource enables

  • Authorization by using a valid postage cash account (Portokosse)
  • Creation of a bearer token for authentication when using subsequent resource paths
  • Display of the current credit balance
  • Calling up the respective user profile

Note:

Direct top-up of the of postage cash account via the INTERNETMARKEN API is only possible if direct debit data is registered and a currently valid direct debit mandate is available.

The use of an alternative payment method for loading postage cash account (PayPal) is only possible manually via the web interface https://portokasse.deutschepost.de/portokasse/#!/.
 

The ApiVersionResource is used for

  • Request information about the API
  • Health check to verify the availability of the web service.

Note:

We recommend implementing and using the health check resource to prevent errors in case the API is not available.

Legal Terms

Please note the terms of use of the Deutsche Post INTERNETMARKE API under "Legal Terms".

Deprecation Schedule

The following table creates transparency about the deprecation dates of previous API versions. To clarify the terms, please see the explanations below.

API Version Status Deprecation Date Sunset Date
INTERNETMARKE (SOAP) Deprecated 01.08.2024 31.12.2025
INTERNETMARKE (REST) Active    

Terms and conditions:

Status "Active": Using this API Version is recommended.

Status "Superseded": The API has been replaced by a new API Version. The API is still supported without limitation. It is recommended to switch to the "Active" API Version.

Status: "Deprecated": The service has been ended (with or without a replacement becoming available). Support for this service is limited to bug fixes only.

Status: "Retired": The API is no longer available since sunset date.

"Deprecation Date": From this date on, the API will be in status "Deprecated". Further development will be only based on security updates and bug fixing.

"Sunset Date": The API is no longer available from this date on.

Postman Collection

To support your software development in the best possible way, we offer you our Postman test suite for download here

You can obtain the well-known API tool Postman itself here: Postman API Platform | Sign Up for Free

To use the Postman Collection, please fulfill the following steps:

  • The usage requires access to Deutsche Post INTERNETMARKE API that can be requested here. Please note that access approval is only granted during business hours and may take up to 24 hours.
  • Import collection into postman (see official documentation from postman learning platform)
  • Fill in the Postman environment with your customer-specific data (credentials from developer portal, customer-specific (test-) postage cash account).

Note:

The Postman Collection is not a product component of the Deutsche Post INTERNETMARKE API, but is intended to support you. 

We would be pleased to receive feedback (errors, suggestions for improvement, etc.).

Explanations on using the API with a postage cash account (Portokasse)

To use the Deutsche Post INTERNETMARKE API, you need a postage cash Account ('Portokasse'). We offer you the option of permanently converting a self-registered Portokasse to an unbilled ‘developer postage cash account/Entwickler-Portokasse'.         
This Portokasse is for development purposes only and may not be used productively!

Register a new Portokasse in the Portokasse web frontend         
Be sure to use a real email address so that you can send and receive messages.

Please do not top up or use this Portokasse for internet stamp creation before the conversion!

To request the conversion, please send an email to it-csp@deutschepost.de         
 

Be sure to provide us with the ID of the portokasse to be converted (visible after successfully registering/logging in to your postage account and the registered email address.

Once the conversion has been completed, you will receive a confirmation email.         
Your new Entwickler-Portokasse will be usable immediately in the API then. You can top up to €1,000 (at a time) via the ‘Interne Aufladung (Internal top-Up)’ function in the web frontend.

Remember to approve your business application once in every used Portokasse (productive and developer Portokasse), to be done in the frontend under ‘Meine Daten (My data) -> Geschäftsanwendungen (Business applications)’. 
When you use a Portokasse for the first time (token retrieval!), you will receive a corresponding message at your Portokasse email address, additionally you will continue getting a "401" error until approval.

 

Support

Questions about API availability?

Visit our IT-Portal for up-to-date information on IT service incidents, planned maintenance windows, and general availability. You can also opt-in for push notifications to receive proactive updates.

Questions about API content or functionality?

Use the “Notify” feature on this page to automatically receive updates about functional changes and enhancements to this API. You can also view our most recent announcements under the “Notifications” section at the bottom of this page.

Technical Support & Assistance

For further help, please visit our Help Center. There you can open a support ticket and receive direct assistance from DHL Support. To help us resolve your issue quickly, please describe your request in as much detail as possible and include traceable excerpts of your web service communication.

Customer Integration Services (CIS)

Business hours: Monday to Friday, 8 a.m. to 16 p.m.

Legal Terms

Terms of Use for the Deutsche Post INTERNETMARKE API (Post & Parcel Germany) 

1. Contracting Parties 

1.1 The contract governing the use of the API “Deutsche Post INTERNETMARKE (Post & Parcel Germany)”, hereinafter referred to as the “INTERNETMARKE API”, is concluded between us, Deutsche Post AG, Charles-de-Gaulle-Straße 20, 53113 Bonn, registered with the Local Court of Bonn under HRB 6792 (hereinafter “DPAG”, “we” or “us”), and you as a business customer and user of the INTERNETMARKE API (hereinafter “you”). 

1.2 The INTERNETMARKE API and the product INTERNETMARKE (including product and price information as well as the INTERNETMARKE General Terms and Conditions) are hereinafter jointly referred to as the “INTERNETMARKE Service”. 

1.3 The contract for the INTERNETMARKE Service is concluded between DPAG and the respective (shipping) end customer (“business end customer”). This may be yourself or a third-party business end customer. 

1.4 The term business (end) customer refers to entrepreneurs within the meaning of Section 14 of the German Civil Code (BGB). Entrepreneurs are natural or legal persons or partnerships with legal capacity who, when concluding a legal transaction, act in the exercise of their commercial or independent professional activity. Business customers also include public-law legal entities, even if they provide their services exclusively on a public-law basis. 

 

2. Subject Matter of the Contract 

We make the INTERNETMARKE API available to you in accordance with the currently valid General Developer Portal Terms of Use (https://developer.dhl.com/terms-use) and the current interface specification (available via the DHL Group API Developer Portal), enabling online creation of postage labels for DPAG products. 
In the event of any conflict or inconsistency between the provisions of the General Developer Portal Terms of Use and these Terms of Use, the provisions of these Terms of Use shall prevail.  
By integrating the INTERNETMARKE API, you may generate postage labels within your application and use them yourself and/or make such postage labels available to business end customers. A prerequisite is that an appropriate payment method for purchasing INTERNETMARKE postage has been stored for the respective user, i.e. for you or the business end customer. 

 

3. Conclusion of Contract 

At the latest upon using the INTERNETMARKE API, you accept these Terms of Use for the Deutsche Post INTERNETMARKE API (Post & Parcel Germany). 
If you yourself use the INTERNETMARKE product via your application, the INTERNETMARKE General Terms and Conditions available at http://www.internetmarke.de/agb.html shall apply. 

 

4. Your Obligations 

4.1 You are obliged to keep your API access credentials secure and confidential and not to disclose them to third parties. 

4.2 Neither your application nor your use of the INTERNETMARKE Service may be used in an unlawful or immoral manner. In particular, it is prohibited to provide the service on websites, apps, platforms, or systems whose content violates the German Criminal Code, the Interstate Treaty on the Protection of Minors in the Media (JMStV), or other applicable law, is sexually offensive, is suitable to seriously endanger or impair the well-being of children or adolescents, or is likely to damage the reputation of DPAG. 
You bear sole and unlimited responsibility and liability for your application and for your use of the INTERNETMARKE Service. 

4.3 You are obliged to design your application in such a way that the offering of the INTERNETMARKE product to business end customers complies with the respective applicable legal requirements. In particular, you must ensure that the INTERNETMARKE General Terms and Conditions of DPAG, available at  
http://www.internetmarke.de/agb.html, are validly incorporated into the contract with the business end customer during the contracting process (prior to the purchase of an INTERNETMARKE via the INTERNETMARKE API). You are responsible for your application and for the correct display and integration of the INTERNETMARKE Service. 

4.4 In the event of changes to the INTERNETMARKE API (pursuant to Section 5.1 below) or to the data provided via the API, you are obliged to adapt your application immediately at your own expense in accordance with DPAG’s specifications. Your right of (extraordinary) termination remains unaffected. 

4.5 You are obliged to comply with DPAG’s style guide requirements for the presentation of the INTERNETMARKE and other information provided via the INTERNETMARKE API and to implement these requirements accordingly in your application. 

 

5. Our Rights and Obligations 

5.1 We are entitled to carry out necessary changes to the INTERNETMARKE Service (e.g. releases or version changes). Performance and price adjustments of the INTERNETMARKE product may be associated with such releases and version changes. We will inform you in due time of any upcoming changes to the INTERNETMARKE Service via the DHL Group Developer Portal (e.g. by banner on developer.dhl.com) or by email. 

5.2 We reserve the right to review sample printouts or similar outputs of INTERNETMARKE postage generated via your application, as well as your application itself. If any defects or errors are identified during such review, you are obliged to remedy them immediately. We reserve the right to suspend your access to the INTERNETMARKE API until the identified defects or errors have been rectified. 

 

6. Liability 

6.1 Notwithstanding the liability provisions of the DHL Group Developer Portal Terms of Use, the following liability provisions shall apply. 

6.2 The parties shall be liable without limitation for all damages caused by intent or gross negligence. 

6.3 In the event of a breach of an essential contractual obligation (cardinal obligation) due to simple negligence, liability for resulting damage to property and pecuniary loss shall be limited to the typical and foreseeable damage under the contract. An essential contractual obligation is an obligation the fulfillment of which is essential for the proper performance of the contract and the breach of which jeopardizes the purpose of the contract, and on whose compliance the parties may regularly rely. Otherwise, liability for simple negligence is excluded.  
This exclusion or limitation of liability shall not apply in the event of injury to life, body or health caused by simple negligence or where DPAG has expressly assumed a guarantee with regard to the INTERNETMARKE Service.  
This provision shall apply accordingly where damage is caused by vicarious agents and/or legal representatives of DPAG. 

6.4 DPAG shall not be liable for damages resulting from service interruptions or delays caused by unforeseeable events for which DPAG, its legal representatives or vicarious agents are not responsible (force majeure). Events of force majeure include, in particular, war, riots, natural disasters, fire, sabotage attacks by third parties (e.g. computer viruses), power failures, official orders, lawful internal labor disputes, and failures or restrictions of communication networks and gateways operated by third parties. 

6.5 You shall be liable to DPAG, in accordance with the above liability provisions, without limitation for all damages, costs, and expenses incurred by DPAG that are causally attributable to a faulty design of your application for which you are responsible. Faulty design exists, for example, if the purchasing process for INTERNETMARKE postage is presented incorrectly, unclearly, or misleadingly and this results in a payment default. Liability shall not apply insofar as the damage is due to circumstances outside your area of responsibility, in particular user errors by end users or systems of DPAG. 

 

7. Indemnification 

7.1 You shall indemnify DPAG and its vicarious agents against all third-party claims (in particular claims arising from copyright, trademark, or unfair competition law) asserted against DPAG as a result of culpable breaches of the obligations set out in these Terms of Use, in particular pursuant to Section 4, regarding the legally compliant integration and design of the INTERNETMARKE offering, and/or as a result of other culpable harmful actions on your part or by third parties attributable to you. The indemnification shall include our necessary and reasonable costs of legal defense (including court and attorney’s fees). 

7.2 We shall inform you without delay of the assertion of such claims and, upon request, provide you with the information required for legal defense. If we make payments to third parties before the entitlement of the claims has been legally established or is undisputed, such payments shall be made subject to a right of reimbursement in the event that the claims prove to be wholly or partially unfounded. 

7.3 Further statutory or contractual claims on our part shall remain unaffected. 

 

8. Data Protection 

The contracting parties undertake to comply with the applicable statutory data protection provisions, in particular the German Federal Data Protection Act (BDSG) and the General Data Protection Regulation (GDPR). 

 

9. Term and Termination 

9.1 The contract is concluded for an indefinite period. Either party may terminate this contract in writing with fourteen (14) working days’ notice. Upon termination of the contract, all rights of use granted shall immediately and automatically expire. After expiry of the contract, the user must immediately delete all content provided by DPAG and confirm such deletion to DPAG in writing. 

9.2 DPAG may terminate or discontinue the contract for use of the INTERNETMARKE API after 180 days of non-use, without requiring a separate written notice of termination. 

9.3 The right of each contracting party to extraordinary termination for good cause shall remain unaffected. Good cause shall include, in particular: 

  • any breach of these Terms of Use or applicable law by the user where continuation of the contract cannot reasonably be expected of DPAG; 

  • any presentation or use of the interface or the information provided by DPAG in a manner that may cause damage to DPAG’s image or create negative impressions among DPAG’s customers. 

 

10. Miscellaneous 

In all other respects, the General Developer Portal Terms of Use of the Deutsche Post & DHL API Developer Portal shall apply. 

Release 1.30
27.Oct.2025

Purely editorial adjustments in descriptions of ,e.g, resource paths, attributes, and examples.

Release 1.29
26.Aug.2025

Professionally

- Introduction of a developer postage cash account to replace the previous test postage account
- Currently valid test postage cash account remain valid until their expiry date

Technically
- Stamps generated with the developer postage cash account contain a ‘sample/Muster’ watermark

Release 1.28
07.Apr.2025
  • One-time registration für new REST based application in every postage  cash account is necessary. A notification email is sent to the registered email address of the Portokasse with the first use.
  • See also section “Explanations on using the API with a postage cash account (Portokasse)”
Release 1.27
12.Feb.2025
  • The CashOnDelivery object has been set to deprecated: It can no longer be used due to the discontinuation of the cash on delivery letter service.
  • Adjustment of the AppShoppingCartPosition object: Removal of the additionalInfo element due to lack of meaning.
Release 1.26
14.Jan.2025

Documentation Error Fix

    Change: The parameter for finalizing shopping carts is "directCheckout".

    Details: In the specificaion and documentation, this parameter was previously incorrectly referred to as "finalize". This error has now been corrected, and the documentation now correctly uses the parameter "directCheckout".

    Example: https://api-eu.dhl.com/post/de/shipping/im/v1/app/shoppingcart/pdf?directCheckout=true

Notifications

07-04-2025 09:31
Deutsche Post INTERNETMARKE (Post & Parcel Germany) - API Page Update

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

07-04-2025 09:29
Deutsche Post INTERNETMARKE (Post & Parcel Germany) - API Page Update

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