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.
last updated Mar 03 2022
Scope
The Parcel DE CSE API allows partners and business customers to push a notification event towards DHL. This event will indicate successful handover to DHL. It is used for international shipping, inbound into Germany, to provide additional visibility to buyers and sellers on progress of the parcel in the originating country.
Using the API
The API is extremely simple, it takes a request document containing parcel (shipment) data and ultimately will make that available via DHL tracking. You will need:
- a valid API key
- know EKP number and shipment details
Example Use Cases
You are a logistics consolidator shipping from China to Germany. You are handing over your shipments to DHL (say, in Shenzhen). To prove timely handover and to add a track event for the recipient, you upload shipment data and handover timestamps to DHL.
This information can be found on DHL tracking pages later.
Get Access
You must request credentials to interact with the Parcel DE Tracking CSE API.
To register your app and get your API subscription keys:
- Click My Apps on the portal website.
- Click the + Add App button.
The "Add App" form appears. - Complete the Add App form.
You can select the APIs you want to access. - When you have completed the form, click the Add App button.
It is possible to use the same app (and same key) for both Sandbox and Production environment.
Access will be manually approved separately for both Sandbox and Production while the API is in closed beta.
Authentication
Every call to the API requires a subscription key. This key needs to be in the request header (DHL-API-Key).
Environments
The addressable API base URL/URI environments are:
| Environment | Description |
| https://api.dhl.com/parcel/de/tracking/cse/v1 | Production environment |
| https://api-sandbox.dhl.com/parcel/de/tracking/cse/v1 | Sandbox environment |
Additional Information
Example requests
Simple upload request example
curl -X POST -d @shipments.json 'https://api-sandbox.dhl.com/parcel/de/tracking/cse/v1/cse?validate=true' -H 'DHL-API-Key:PasteHere_ConsumerKey'
For easier + more complete examples see the API spec, also for the structure of the json data.
Legal terms to be added.
1.0.0
- Initial launch