Sendungsverfolgung

Rufen Sie die Echtzeit-Verfolgungshistorie für ein DPD-Paket ab, einschliesslich aller Statusereignisse, Zeitstempel und Standortinformationen.

Endpunkt: GET /api/v1/tracking/{parcelNumber} Authentifizierung: Bearer JWT-Token erforderlich

---

Anfrage

Pfadparameter:

Parameter	Typ	Pflichtfeld	Beispiel
parcelNumber	String	Ja	05305000123456

Abfrageparameter:

Parameter	Typ	Pflichtfeld	Beschreibung
locale	String	Optional	Beschreibungen lokalisieren – de_CH, en_US, fr_CH, it_CH

# Einfach
curl -X GET "https://label-print-shipments.dpd.ch/api/v1/tracking/05305000123456" \
  -H "Authorization: Bearer <jwt_token>"

# Mit locale
curl -X GET "https://label-print-shipments.dpd.ch/api/v1/tracking/05305000123456?locale=en_US" \
  -H "Authorization: Bearer <jwt_token>"

---

Antwort

200 OK:

{
  "shipmentInfo": {
    "type": "shipment",
    "service": "PSD",
    "product": "DPD Classic"
  },
  "statusInfo": [
    {
      "name": "ACCEPTED",
      "displayName": "Paket an DPD übergeben",
      "description": "DPD hat Ihr Paket erhalten.",
      "location": "",
      "date": "2025-10-29 14:30:00",
      "hasBeenReached": true,
      "isCurrent": false
    },
    {
      "name": "AT_SENDING_DEPOT",
      "displayName": "Paket unterwegs",
      "description": "Das Paket befindet sich im Paketversandzentrum.",
      "location": "Bern Hub",
      "date": "2025-10-30 08:15:00",
      "hasBeenReached": true,
      "isCurrent": true
    },
    {
      "name": "DELIVERED",
      "displayName": "Paket zugestellt",
      "description": "Ihr Paket wurde erfolgreich zugestellt.",
      "location": "",
      "date": "",
      "hasBeenReached": false,
      "isCurrent": false
    }
  ]
}

Felder in statusInfo

Feld	Typ	Beschreibung
name	String	Statuscodekennung
displayName	String	Übersetztes Status-Label
description	String	Übersetzte Detailbeschreibung
location	String	Ort, an dem das Ereignis eingetreten ist
date	String	Zeitstempel (yyyy-MM-dd HH:mm:ss), leer wenn noch nicht erreicht
hasBeenReached	Boolean	Ob dieser Status bereits eingetreten ist
isCurrent	Boolean	Ob dies der aktuelle Status ist

---

Statuscodes

Status	Englisch (en_US)	Deutsch (de_CH)	Französisch (fr_CH)	Italienisch (it_CH)
ACCEPTED	Parcel handed to DPD	Paket an DPD übergeben	Colis reçu	Pacco ricevuto
AT_SENDING_DEPOT	In transit	Paket unterwegs	Colis en cours d'acheminement	Pacco in viaggio
ON_THE_ROAD	At parcel delivery centre	Im Paketzustellzentrum	Colis au centre de tri	Pacco nel centro consegne pacchi
AT_DELIVERY_DEPOT	Parcel out for delivery	In Zustellung	Colis livré	Pacco consegnato
DELIVERED	Parcel delivered	Paket zugestellt	Colis livré	Pacco consegnato

Typischer Statusablauf

ACCEPTED → AT_SENDING_DEPOT → ON_THE_ROAD → AT_DELIVERY_DEPOT → DELIVERED

---

HTTP-Statuscodes

Code	Beschreibung
200 OK	Verfolgungsdaten zurückgegeben
401 Unauthorized	Token fehlt oder ist ungültig
404 Not Found	Paketnummer nicht gefunden