Scope

The Products API provides price and specification information about products of

• Deutsche Post Germany

Product specific prices and additional product information please find at: Leistungen und Preise

Exemptions

The Products API does not deliver customer individual prices.

Prerequisites

You can access the Products API (Post & Parcel Germany) by using the same API-KEY from your APP including the Deutsche Post INTERNETMARKE API.

Using the API

Main Functional Features

1. Provision of Product Information

• Access to relevant mail products
• Description of service features (e.g., weight, dimensions)
• Representation of national and international shipping options
• Identification of additional services (e.g., registered mail)    
   

2. Rate and Price Calculation

• Return of valid prices for the selected product

   

Functional Data Objects

Get Access

How to register your Products API and get your API subscription keys:

Currently the API is a service for using Deutsche Post INTERNETMARKE API. 

Authentication

The authentication of the API is API-Key based. In order to request products information, please use your personal API Key.

You automatically have access to this Products API when you are using Deutsche Post INTERNETMARKE (Post & Parcel Germany) API. Use your  API key/client-id for acessing the Products API as well.

curl --request GET \
 --url 'https://api-eu.dhl.com/post/de/information/v1/products?profile=IM-PARTNER' \
 --header 'dhl-api-key: {{YOUR_API_KEY}}'

Please notice: 

For this specific API, we provide only the production web service endpoint. This ensures that you always have access to up-to-date product information, even during the development process. 

 

At present, we are only making the “IM-PARTNER” profile available to development partners and users of the Internetmarken API. We will make further profiles available at a later date.

Using the API

Example for requesting list of products within profile IM-PARTNER (profile=IM-PARTNER) and reducing the amount of returned values with the shortVersion Parameter (shortVersion=true):

Request:

curl --request GET \
 --url 'https://api-eu.dhl.com/post/de/information/v1/products?profile=IM-PARTNER&shortVersion=true' \
 --header 'dhl-api-key: {{YOUR_API_KEY}}'

Response:

{
 "type": "PwsProducts",
 "date": "11.12.25, 13:46",
 "shortSalesProducts": [
   {
     "productid": "355",
     "extProductname": "Streifbandzeitung 501 g bis 1000 g",
     "extProductid": "405",
     "extIdSource": "PPL",
     "transport": "national",
     "startDate": "2023-01-01T00:00:00",
     "endDate": "2025-12-31T23:59:59",
     "grossprice": 2.68,
     "startdatePrice": "2023-01-01T00:00:00",
     "currency": "EUR",
     "minLength": 140,
     "maxLength": 353,
     "minWidth": 90,
     "maxWidth": 250,
     "minHeight": 0,
     "maxHeight": 50,
     "minWeight": 501,
     "maxWeight": 1000
   }, 
   { ... }]
}

Notes:
•    You must specify the desired profile in the request.
•    Currently, only the shortVersion (shortVersion=true) is officially supported; due to the dynamic content (product-specific structures), complexity and size of the response, the longVersion (shortVersion=false) is currently reserved for internal use only. Any use within your application is at your own risk.