ParcelLifeCycle Service
-
Introduction
The ParcelLifecycle Service allows you to track the current status and history of individual parcels during transit and after delivery. Tracking information is retrieved from DPD’s central databases, which are continuously updated.
It supports tracking of any parcel shipped via DPD, regardless of whether it was created using DPD Shipper Webservices. However, you can only track parcels that fall within your own shipping volumes — parcels outside your shipping account are not accessible. The endpoint returns the parcel status and history in a fixed format, which can be integrated into your internal systems for real-time tracking and monitoring.
Please note that this service is limited to single-parcel tracking only. For more extensive tracking capabilities — such as detailed delivery reasons or multi-shipment overviews — you can consult DPD Insights or explore other DPD tracking services that may better suit your needs.
-
REST URL
-
Request
{ "authentication": { "delisId": "*****", "authToken": "*****", "messageLanguage": "nl_NL" }, "getTrackingData":{ "parcelLabelNumber":"05222835034925" } } -
Response
{ "getTrackingDataResponse": { "trackingResult": { "shipmentInfo": { "receiver": null, "predictInformation": null, "serviceDescription": { "label": { "content": "Your DPD service:", "bold": false, "paragraph": false }, "content": [ { "content": "", "bold": false, "paragraph": false } ], "linkTarget": null }, "additionalServiceElements": null, "trackingProperty": null, "status": "SHIPMENT", "label": null, "description": null, "statusHasBeenReached": false, "isCurrentStatus": false, "showContactInfo": false, "location": null, "date": null, "normalItems": [], "importantItems": [], "errorItems": [] }, "statusInfo": [ { "status": "BetweenDepots", "statusInfoStatus": 0, "label": { "content": "In transit", "bold": true, "paragraph": false }, "description": { "label": null, "content": [ { "content": "The parcel is at the parcel dispatch centre.", "bold": false, "paragraph": false } ], "linkTarget": null }, "statusHasBeenReached": true, "isCurrentStatus": false, "showContactInfo": true, "location": { "content": "Veenendaal (NL)", "bold": true, "paragraph": false }, "date": { "content": "5/28/2025 8:52:14 PM", "bold": true, "paragraph": false }, "normalItems": [], "importantItems": [], "errorItems": [] }, { "status": "BetweenDepots", "statusInfoStatus": 0, "label": { "content": "In transit", "bold": true, "paragraph": false }, "description": { "label": null, "content": [ { "content": "The parcel is at the parcel dispatch centre.", "bold": false, "paragraph": false } ], "linkTarget": null }, "statusHasBeenReached": true, "isCurrentStatus": false, "showContactInfo": true, "location": { "content": "Veenendaal (NL)", "bold": true, "paragraph": false }, "date": { "content": "5/28/2025 9:18:59 PM", "bold": true, "paragraph": false }, "normalItems": [], "importantItems": [], "errorItems": [] }, { "status": "Depot", "statusInfoStatus": 0, "label": { "content": "Parcel out for delivery", "bold": true, "paragraph": false }, "description": { "label": null, "content": [ { "content": "At parcel delivery centre.", "bold": false, "paragraph": false } ], "linkTarget": null }, "statusHasBeenReached": true, "isCurrentStatus": false, "showContactInfo": true, "location": { "content": "Goes (NL)", "bold": true, "paragraph": false }, "date": { "content": "5/31/2025 3:00:00 AM", "bold": true, "paragraph": false }, "normalItems": [], "importantItems": [], "errorItems": [] }, { "status": "Courier", "statusInfoStatus": 0, "label": { "content": "Parcel out for delivery", "bold": true, "paragraph": false }, "description": { "label": null, "content": [ { "content": "The parcel has left the parcel delivery centre and is on its way to the consignee.", "bold": false, "paragraph": false } ], "linkTarget": null }, "statusHasBeenReached": true, "isCurrentStatus": false, "showContactInfo": true, "location": { "content": "Goes (NL)", "bold": true, "paragraph": false }, "date": { "content": "5/31/2025 9:47:31 AM", "bold": true, "paragraph": false }, "normalItems": [], "importantItems": [], "errorItems": [] }, { "status": "Delivered", "statusInfoStatus": 0, "label": { "content": "Parcel delivered", "bold": true, "paragraph": false }, "description": { "label": null, "content": [ { "content": "Your parcel has been delivered successfully.", "bold": false, "paragraph": false } ], "linkTarget": null }, "statusHasBeenReached": true, "isCurrentStatus": false, "showContactInfo": true, "location": { "content": "Goes (NL)", "bold": true, "paragraph": false }, "date": { "content": "5/31/2025 2:33:37 PM", "bold": true, "paragraph": false }, "normalItems": [], "importantItems": [], "errorItems": [] }, { "status": "Delivered", "statusInfoStatus": 0, "label": { "content": "Parcel delivered", "bold": true, "paragraph": false }, "description": { "label": null, "content": [ { "content": "Your parcel has been delivered successfully.", "bold": false, "paragraph": false } ], "linkTarget": null }, "statusHasBeenReached": true, "isCurrentStatus": true, "showContactInfo": true, "location": { "content": "Goes (NL)", "bold": true, "paragraph": false }, "date": { "content": "5/31/2025 3:08:00 PM", "bold": true, "paragraph": false }, "normalItems": [], "importantItems": [], "errorItems": [] } ], "contactInfo": null } }, "status": { "type": "OK", "code": "200", "message": "valid" } } -
Parameters
Request
Field Data Type Mandatory Range Description delisId xs:string Yes The delis user id for authentication. authToken xs:string Yes The token for authentication. Field authToken of Login, as a result of Method “getAuth” of LoginService. messageLanguage xs:string Yes length:5 The language for messages.
“nl_NL” for Dutch messages.
“en_US” for English messages.parcelLabelNumber xs:string Yes length:14 Parcel label number.
ResponseField Data Type Description receiver xs:integer Receiver of the parcel. predictInformation xs:string Information about estimated delivery time of parcel (DPD Predict). serviceDescription xs:string Name of DPD product of the parcel (e.g. DPD Classic). additionalServiceElements xs:string Additional services for DPD product. trackingProperty xs:string Tracking properties. status xs:string Status of the parcel. label xs:string Name of the status. description xs:string Description of the status. statusHasBeenReached xs:boolean Indicates if status has been reached. isCurrentStatus xs:boolean Indicates if status is current status. showContactInfo xs:boolean Defines if contact information shall be displayed on detail page of the status. location xs:string Contains the location of the last scan. date xs:string Contains the date of the last scan. normalItems xs:string A list of content items which describe events classified as normal. importantItems xs:string A list of content items which describe events classified as important. errorItems xs:string A list of content items which describe events classified as error. -
Status Codes
- PickedUp – Accepted (and picked-up) by DPD
- Depot – At delivery depot
- BetweenDepots – On a transport between DPD Hubs/Depots
- Courier – Out for delivery
- ReturningFromDelivery – Returned to delivery depot
- DeliveryFailure – Unable to deliver the parcel
- Customs – At cross border checking (for non-EU shipments)
- Warehouse – Held at warehouse for consolidation/rerouting
- ParcelShop – At a pickup point
- Consolidation – Parcel consolidated for new delivery
- Delivered – Parcel received by recipient.