DHL ACT Webservices

Introduction and prerequisites

Welcome to DHL Freight’s Tracking API WebService.
It provides API access to DHL Freight’s Track & Trace ‘Active Tracing’ solution (at https://activetracing.dhl.com).

A prerequisite of using the AcT WebServices is that you must first have a registered ‘myACT’ Active Tracing login – your myACT login will be configured with your DHL Account Number(s), whereby all AcT WebService Responses will be limited to those shipments with matching DHL Account Number(s) configured against your myACT login. Please use this link to register an account if you do not already have an active ‘myACT’ account.

For full specifications please refer to DHL ACT documentation.

API specifications

The API gives access to:

  • Shipment Details
  • Latest Shipment Status & Location
  • Full Tracking Event History (Shipment Level & Package Level)
  • POD (Proof Of Delivery) documents (& some other documents available)

The API supports 5 operations:

  • GetConsignmentsByIdentifier: can be used if the DHL Order-Code, ShipmentID, or Package-IDis known.
  • GetConsignmentsByReference: can be used if an exact Customer Reference String of a shipment is known.
  • GetConsignmentsByAccountNumbers: returns all shipments/events, based on Customer DHL Account Number(s), can be used with date/time-parameters.
  • GetLatestEventByIdentifiers: returns Latest Status & Location for multiple Shipment IDs (not Customer References), no Shipment Details / Event History.
  • GetEpodsSync: returns ePods (& some other documents possible) of shipments immediately (synchronous), suitable for up to 10 Shipment-IDs, per Request.

26-04-2024 - At this stage we do not have the infrastructure in place for scheduling the API calls. For that reason we have decided to implement only the GetConsignmentsByReference operation a this stage.

Tracking events expected

The following event / reason codes can be returned by the API:

Event CodeReason CodeCodeEvent Description
ACT2ACT,2Consignment created
64064,0Collection arranged - OK
48048,0Loaded by customer ready for Collection
1550115,501Out for Collection
5521155,211Not Collected - consignor closed
556855,68Not Collected - customer not ready
552155,21Not Collected - customer refusal
5512655,126Not Collected - customs issue
5524055,240Not Collected - DHL refusal, goods not transportable
5524155,241Not Collected - missing or wrong reference
5526555,265Not Collected - other reasons
5529455,294Not Collected - time issue
552055,20Not Collected - traffic jam
5526655,266Not Collected - weather condition issue
5523455,234Not Collected - wrong address
13013,0Collected
24024,0Shipped from terminal
101,0Received at terminal
2012620,126On hold - in customs clearance.
12012,0Customs cleared
2026620,266Delayed during transport - bad weather.
2035420,354Delayed during transport - bank holiday.
2027020,270Exception occurred - Strike.
707,0New shipping instruction - consignment cancelled by sender
5622256,222New shipping instruction - shipment returned.
1211,21Arrival at destination
2020820,208Shipment in warehouse – Awaiting delivery appointment
2020920,209Shipment in warehouse – Delivery appointment booked
201320,13Shipment in warehouse - ready for self collection by consignee
2029620,296Shipment in warehouse - waiting for consignee payment.
2462824,628Direct delivery
2450124,501Out for Delivery
2021120,211Attempted DHL delivery - consignee closed
5621156,211Attempted DHL delivery - consignee not met
5629256,292Attempted DHL delivery - refused by consignee, COD/DAD problem.
5622156,221Attempted DHL delivery - refused by consignee, wrong address information
5628456,284Attempted DHL delivery - refused by consignee, wrong goods.
5661156,611Attempted DHL delivery - refused by consignee.
5624156,241Attempted DHL delivery - refused due to missing documents
2023420,234Attempted DHL delivery - wrong consignee address
4070240,702Loaded into ferry
2460024,600Received by consignee
2123421,234Shipment delivered - new delivery address following consignee instruction
212321,23Shipment delivered with exception - partly delivered
2160021,600Shipment delivered with exception.
21021,0Delivered