Ontvang trackinggegevens van een pakket en de huidige status.

Geef de shortUid van de bestelling en de checkpoints die de huidige status en updates van het pakket aangeven.

GET /v1/tracking/{trackingNumber}

Voorbeeld aanvragen

/v1/tracking/EXMPL0001234TRCKNUM

Voorbeeld van een succesvolle reactie

{
  "shortUid": "EXMPL0001234",
  "trackingNumber": "EXMPL0001234TRCKNUM",
  "trackingUrl": "https://mydhl.express.dhl/no/en/tracking.html#/results?id=EXMPL0001234TRCKNUM",
  "shipmentMethodUid": "dhl_express_worldwide",
  "shipmentMethodName": "DHL Express Worldwide",
  "carrierUid": "dhl_express",
  "carrierName": "DHL Express",
  "weightInGrams": "460",
  "checkpoints": [
    {
      "status": 6,
      "message": "Delivered",
      "description": "Delivered",
      "location": "LONDON-GBR, United Kingdom",
      "createdAt": "2024-07-29T18:16:06Z",
      "expectedDeliveryDate": "",
      "statusUid": "delivered",
      "signedBy": "aftership"
    },
    {
      "status": 2,
      "message": "Shipment is out with courier for delivery",
      "description": "Out for Delivery",
      "location": "LONDON-GBR, United Kingdom",
      "createdAt": "2024-07-29T08:58:40Z",
      "expectedDeliveryDate": "",
      "statusUid": "out_for_delivery",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Arrived at DHL Sort Facility LONDON-HEATHROW-GBR",
      "description": "Arrival scan",
      "location": "LONDON-HEATHROW-GBR, United Kingdom",
      "createdAt": "2024-07-29T00:35:29Z",
      "expectedDeliveryDate": "",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Scheduled to depart on the next planned movement",
      "description": "Departure Scan",
      "location": "EAST MIDLANDS-GBR, United Kingdom",
      "createdAt": "2024-07-28T12:02:21Z",
      "expectedDeliveryDate": "2024-07-30",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Customs clearance status updated. Note - The Customs clearance process may start while the shipment is in transit to the destination.",
      "description": "Customs clearance started",
      "location": "EAST MIDLANDS-GBR, United Kingdom",
      "createdAt": "2024-07-26T13:00:23Z",
      "expectedDeliveryDate": "2024-07-30",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Shipment has departed from a DHL facility ULM-DEU",
      "description": "Departure Scan",
      "location": "ULM-DEU, Germany",
      "createdAt": "2024-07-25T16:41:58Z",
      "expectedDeliveryDate": "2024-07-30",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Shipment picked up",
      "description": "Acceptance scan",
      "location": "ULM-DEU, Germany",
      "createdAt": "2024-07-25T14:21:55Z",
      "expectedDeliveryDate": "2024-07-30",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    }
  ]
}

Voorbeeld van foutmelding

{
  "trackingNumber": "EXMPL0001234TRCKNUM",
  "code": "TRACKING_DETAILS_NOT_FOUND",
  "message": "Tracking details not found.",
  "details": null
}

Request

Parameter	Type	Beschrijving
`trackingNumber` (verplicht)	string	Het pakketvolgnummer dat door de vervoerder wordt verstrekt

Succesvolle reactie

Parameter	Type	Beschrijving
`shortUid` (verplicht)	string	Een unieke korte identificatiecode voor de reactie
`trackingNumber` (verplicht)	string	Het trackingnummer van het pakket
`trackingUrl` (optioneel)	string	Tracking-URL van de vervoerder van het pakket
`shipmentMethodUid` (optioneel)	string	UID van de verzendmethode die wordt gebruikt om het pakket te leveren
`shipmentMethodName` (optioneel)	string	Naam van de verzendmethode die wordt gebruikt om het pakket te bezorgen
`carrierUid` (optioneel)	string	UID van de vervoerder die wordt gebruikt om het pakket te bezorgen
`carrierName` (optioneel)	string	Naam van de vervoerder die wordt gebruikt om het pakket te bezorgen
`weightInGrams` (optioneel)	string	Gewicht van het pakket in gram
`checkpoints` (optioneel)	CheckPoint[]	Een reeks CheckPoint-objecten (kan leeg zijn)

CheckPoint

Parameter	Type	Beschrijving
`status` (verplicht)	nummer	Status-ID-nummer
`statusUid` (verplicht)	string	Status UID (zie StatusEnum)
`message` (verplicht)	string	Statusbericht
`description` (optioneel)	string	Statusbeschrijving
`location` (optioneel)	string	Huidige locatie van het pakket (adres)
`createdAt` (verplicht)	string	Status aangemaakt op (RFC3339)
`expectedDeliveryDate` (optioneel)	string	Verwachte leverdatum (`YYYY-MM-DD`). Voorbeeld: `2024-01-21`
`signedBy` (verplicht)	string	Welke aanbieder/dienst heeft het ondertekend

StatusEnum

Statuswaarde	Beschrijving
`geregistreerd`	Geeft de geregistreerde status weer
`onderweg`	Geeft de status "onderweg" aan
`Onderweg`	Geeft de status "wordt bezorgd" weer
`mislukte poging`	Geeft de status van een mislukte poging weer
`verzendingsuitzondering`	Geeft de status van een verzenduitzondering weer
`beschikbaar voor afhalen`	Geeft de status "beschikbaar voor afhalen" aan
`geleverd`	Geeft de status "geleverd" aan
`verzonden`	Geeft de verzonden status weer
`geretourneerd`	Geeft de status "geretourneerd" weer
`niet opgehaald`	Geeft de status "niet opgehaald" aan

Foutmelding

Parameter	Type	Beschrijving
`trackingNumber`	string	Het trackingnummer van het pakket
`code`	string	Foutcode
`Bericht`	string	Foutmelding
`details` (optioneel)	ResponseErrorDetails	Aanvullende foutdetails

ResponseErrorDetails

Parameter	Type	Beschrijving
code	string	Foutcode.
Bericht	string	Foutmelding
referentie (optioneel)	string	Referentie-ID.

Volgende stap: 🔗[GCL] Logistics API - Postman Collection

📝 Niet wat je nodig had?

Help ons dit artikel te verbeteren, stuur ons een e-mail naar [email protected] — vermeld alsjeblieft de titel van het artikel.

[GCL] Logistics API - Tracking