DHL Shipment Tracking Virtual Sandbox

Real-time shipment status and delivery verification API.

The Unified Shipment Tracking API provides up-to-the-minute status reports for DHL shipments. It allows developers to retrieve tracking information, identify the specific service provider involved, and verify delivery addresses to reduce misdeliveries. The API supports ISO 8601 date and time formats for all event timestamps.

Use this hosted sandbox to simulate DHL Shipment Tracking APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate shipment tracking workflows, including parsing status updates, handling various ISO 8601 date formats, verifying address-matching logic, and testing error responses for invalid tracking numbers or missing shipment events.

DHL Shipment Tracking virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate DHL Shipment Tracking responses instantly.

`https://dhl-shipment-tracking.mock.beeceptor.com`

General

GET

/shipments

Retrieves the tracking information for shipments(s). The shipments are identified using the required `trackingNumber` query parameter.

Query Parameter Name	Example
`trackingNumber`*	`ea quis consectetur`
`service`	`express`
`requesterCountryCode`	`occaecat voluptate aute`
`originCountryCode`	`cupidatat`
`recipientPostalCode`	`ex do dolor Ut est`
`language`	`anim aliqua in cupidatat`
`offset`	`7195971.240487963`
`limit`	`58412279.21573785`

Request Payload

Response Payload

{
  "url": "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&limit=10",
  "firstUrl": "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&limit=10",
  "prevUrl": "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&limit=10",
  "nextUrl": "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&limit=10",
  "lastUrl": "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&limit=10",
  "shipments": [
    {
      "id": "GMDBD8E9CCE94842E495B7",
      "service": "ecommerce",
      "origin": {
        "address": {
          "countryCode": "US",
          "postalCode": "84003",
          "addressLocality": "AMERICAN FORK"
        }
      },
      "destination": {
        "address": {
          "countryCode": "GB",
          "postalCode": "S87FA",
          "addressLocality": "SHEFFIELD"
        }
      },
      "status": {
        "timestamp": "2023-01-29T16:02:00",
        "location": {
          "address": {
            "countryCode": "UK",
            "postalCode": "HEATHROW",
            "addressLocality": "HEATHROW, GB"
          }
        },
        "statusCode": "transit",
        "status": "ARRIVED AT CUSTOMS"
      },
      "details": {
        "product": {
          "productName": "DHL Parcel Intl Standard"
        },
        "weight": {
          "value": 0.831,
          "unitText": "LB"
        },
        "references": [
          {
            "number": "GMDBD8E9CCE94842E495B7",
            "type": "customer-confirmation-number"
          },
          {
            "number": "2042200157621303",
            "type": "ecommerce-number"
          },
          {
            "number": "H01PQA0010751022",
            "type": "local-tracking-number"
          }
        ]
      },
      "events": [
        {
          "timestamp": "2023-01-29T16:02:00",
          "location": {
            "address": {
              "countryCode": "UK",
              "postalCode": "HEATHROW",
              "addressLocality": "HEATHROW, GB"
            }
          },
          "statusCode": "transit",
          "status": "ARRIVED AT CUSTOMS"
        },
        {
          "timestamp": "2023-01-23T08:52:15",
          "location": {
            "address": {
              "countryCode": "US",
              "postalCode": "90601",
              "addressLocality": "Whittier, CA, US"
            }
          },
          "statusCode": "unknown",
          "status": "SCANNED INTO SACK/CONTAINER"
        },
        {
          "timestamp": "2023-01-23T08:52:14",
          "location": {
            "address": {
              "countryCode": "US",
              "postalCode": "90601",
              "addressLocality": "Whittier, CA, US"
            }
          },
          "statusCode": "transit",
          "status": "PROCESSING COMPLETED AT ORIGIN"
        },
        {
          "timestamp": "2023-01-23T08:50:36",
          "location": {
            "address": {
              "countryCode": "US",
              "postalCode": "90601",
              "addressLocality": "Whittier, CA, US"
            }
          },
          "statusCode": "unknown",
          "status": "CLOSE BAG"
        },
        {
          "timestamp": "2023-01-20T14:04:18",
          "location": {
            "address": {
              "countryCode": "US",
              "postalCode": "90601",
              "addressLocality": "Whittier, CA, US"
            }
          },
          "statusCode": "transit",
          "status": "PROCESSED"
        },
        {
          "timestamp": "2023-01-20T10:21:25",
          "statusCode": "pre-transit",
          "status": "DHL ECOMMERCE CURRENTLY AWAITING SHIPMENT AND TRACKING WILL BE UPDATED WHEN RECEIVED"
        },
        {
          "timestamp": "2023-01-18T09:39:28",
          "location": {
            "address": {
              "countryCode": "US",
              "postalCode": "90601",
              "addressLocality": "Whittier, CA, US"
            }
          },
          "statusCode": "transit",
          "status": "PACKAGE RECEIVED AT DHL ECOMMERCE DISTRIBUTION CENTER"
        },
        {
          "timestamp": "2023-01-11T11:58:34",
          "statusCode": "unknown",
          "status": "LABEL CREATED"
        }
      ]
    }
  ],
  "possibleAdditionalShipmentsUrl": [
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=freight",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=dgf",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=parcel-de",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=parcel-nl",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=parcel-pl",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=express",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=post-de",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=sameday",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=parcel-uk",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=ecommerce-apac",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=ecommerce-europe",
    "/track/shipments?trackingNumber=GMDBD8E9CCE94842E495B7&service=post-international"
  ]
}

{
  "detail": "Internal error occurred",
  "instance": "https://internal-unique.com/",
  "status": 208,
  "title": "Bad Request",
  "type": "InternalServerException"
}

Service Homepage: developer.dhl.com/api-reference/shipment-tracking#reference-docs-section

logisticstrackingshippingdhlrest