An order shipped domestically and one shipped with DHL live in one list and speak one status vocabulary. A single DHL key covers Express, eCommerce, Parcel and Freight.
Shipment Tracking – Unified: DHL's official API, which answers for a shipment in any division — Express, eCommerce, Parcel, Freight. Creating labels is not part of it: that is MyDHL API, a separate product with its own contract, and we do not promise it.
DHL has one dictionary for every division and every country, so it is deliberately coarser than a national carrier's.
pre-transit — label created, DHL has not collected it
Pending
transit — on its way
In transit
delivered
Delivered
failure — delivery did not happen
Failed
unknown — DHL holds no data for the number
nothing changes
All three limits are stated plainly, because each one shapes how often statuses refresh.
developer.dhl.com → create an app → subscribe it to Shipment Tracking – Unified → copy the API Key.
Settings → Integrations → Platform adapters → DHL. The key is stored encrypted and never reaches the browser.
The CRM makes one request with a deliberately impossible number: DHL answers “no such shipment”, which proves the key works without spending a real waybill.
Connect DHL and see international shipments where the domestic ones already are.