DHL Mail Communication Tracking Virtual Sandbox

Automated push notifications for mail shipment status updates.

The Tracking Push-API allows business customers to subscribe to daily push notifications regarding the shipment status of their mail items. It provides a structured way to receive event-driven updates on mail delivery progress.

Use this hosted sandbox to simulate DHL Mail Communication 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 subscription workflows, handle incoming push notification payloads, test status update parsing, and verify error handling for subscription management, confirmation, and replay requests.

DHL Mail Communication Tracking virtual sandbox is up and running!

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

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

Subscription Creation(3 operations)

GET

/certificates/default

This certificate can be used by push consumers to validate the signature on incoming notifications (shipment update messages) sent to the consumer's endpoint, i.e. validate that these notifications were sent by the push service. Please refer to the API documentation on how to validate the signa

Request Payload

Response Payload

-----BEGIN CERTIFICATE----- <CERTIFICATE CONTENT> -----END CERTIFICATE-----

{
  "detail": "Invalid request format.",
  "instance": "https://far-off-affect.com/",
  "statusCode": 400,
  "title": "OK"
}

POST

/subscriptions

Create operation for a new push subscription with settings as payload. A maximum of 3 (three) subscriptions per user is allowed.

Request Payload

{
  "dataCallbackURL": "https://normal-exhaust.info/",
  "email": "Cristal55@gmail.com",
  "exportFormat": "application/json",
  "id": "d2be3fa0-ca5e-4812-a514-cbbb2c39367e",
  "language": "en",
  "numberOfRecords": 407,
  "validationCallbackURL": "https://unaware-smoke.info/"
}

Response Payload

{
  "dataCallbackURL": "https://pretty-kielbasa.com/",
  "email": "Zion.Hessel85@yahoo.com",
  "exportFormat": "application/json",
  "id": "b4a6a652-fd17-4701-a17d-9a3404e2cf25",
  "language": "de",
  "numberOfRecords": 111,
  "validationCallbackURL": "https://silent-coin.name/"
}

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://little-dime.name/",
  "statusCode": 202,
  "title": "OK"
}

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://early-airman.com/",
  "statusCode": 401,
  "title": "OK"
}

{
  "detail": "Invalid request format.",
  "instance": "https://lighthearted-rationale.org/",
  "statusCode": 202,
  "title": "Accepted"
}

POST

/subscriptions/{id}/confirmation

Posting a the signature to the confirmation ressource is the final step in the creation of a subscription. A response with code 204 confirms the subscription.

Request Payload

{
  "signature": "hIANH1e95kNh3o11ozDgWztUWQ4xUMCYrJivBeEGeRamHqXjzFcSDBTNNE5qCU5s"
}

Response Payload

Missing schema or example in the OpenAPI spec.
Update the definition and recreate the mock server.

{
  "detail": "Internal service failure.",
  "instance": "https://our-sediment.biz",
  "statusCode": 400,
  "title": "Bad Request"
}

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://dual-graffiti.name/",
  "statusCode": 200,
  "title": "Internal Server Error"
}

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://square-pearl.com/",
  "statusCode": 202,
  "title": "Bad Request"
}

Subscription Management(4 operations)

GET

/subscriptions

All subscriptions of a user

Request Payload

Response Payload

[
  {
    "dataCallbackURL": "https://likable-paintwork.biz/",
    "email": "Moses.Kessler@gmail.com",
    "exportFormat": "application/json",
    "id": "444fd5e6-e158-44b0-9567-fa340ef79298",
    "language": "en",
    "numberOfRecords": 289,
    "validationCallbackURL": "https://faint-foodstuffs.com/"
  },
  {
    "dataCallbackURL": "https://warlike-smoke.info/",
    "email": "Alene34@gmail.com",
    "exportFormat": "application/xml",
    "id": "fdfe3ae0-f229-44b6-b10d-9adb08f44aac",
    "language": "en",
    "numberOfRecords": 461,
    "validationCallbackURL": "https://doting-saloon.name"
  },
  {
    "dataCallbackURL": "https://yearly-suitcase.com/",
    "email": "Kaleigh.Runolfsson96@gmail.com",
    "exportFormat": "application/json",
    "id": "fa5c0d74-ab65-4898-a021-a71fe782a085",
    "language": "de",
    "numberOfRecords": 82,
    "validationCallbackURL": "https://homely-exterior.name/"
  },
  {
    "dataCallbackURL": "https://substantial-stay.org",
    "email": "Edwardo47@gmail.com",
    "exportFormat": "application/xml",
    "id": "76a072ad-51ca-4571-99e1-51f3295a41be",
    "language": "de",
    "numberOfRecords": 302,
    "validationCallbackURL": "https://fantastic-management.biz/"
  }
]

{
  "detail": "Internal service failure.",
  "instance": "https://back-resource.name",
  "statusCode": 401,
  "title": "Not Found"
}

{
  "detail": "Subscription not found.",
  "instance": "https://plain-zen.biz",
  "statusCode": 202,
  "title": "Bad Request"
}

GET

/subscriptions/{id}

Gets a push subscription by its id

Request Payload

Response Payload

{
  "dataCallbackURL": "https://deficient-scarification.com",
  "email": "Howard.Sanford35@yahoo.com",
  "exportFormat": "application/json",
  "id": "73c471c8-4d97-45cf-b36c-a3ba44474659",
  "language": "en",
  "numberOfRecords": 417,
  "validationCallbackURL": "https://velvety-bar.com"
}

{
  "detail": "Internal service failure.",
  "instance": "https://instructive-jazz.info",
  "statusCode": 404,
  "title": "Bad Request"
}

{
  "detail": "Subscription not found.",
  "instance": "https://better-subexpression.info",
  "statusCode": 403,
  "title": "OK"
}

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://concrete-bookcase.net",
  "statusCode": 403,
  "title": "Not Found"
}

PUT

/subscriptions/{id}

Update operation for specific push subscription by ID with the new settings as payload.

Request Payload

{
  "email": "Lonny11@gmail.com",
  "exportFormat": "application/json",
  "language": "de",
  "numberOfRecords": 40
}

Response Payload

{
  "dataCallbackURL": "https://ornery-daddy.name/",
  "email": "Trinity.Durgan42@hotmail.com",
  "exportFormat": "application/xml",
  "id": "31d30ba8-d667-414b-9592-3b2bc3739b51",
  "language": "en",
  "numberOfRecords": 407,
  "validationCallbackURL": "https://trained-bathhouse.com"
}

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://stupendous-sideboard.org/",
  "statusCode": 403,
  "title": "Internal Server Error"
}

{
  "detail": "Subscription not found.",
  "instance": "https://potable-divine.com/",
  "statusCode": 403,
  "title": "OK"
}

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://slight-farm.name/",
  "statusCode": 201,
  "title": "Not Found"
}

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://likely-vestment.name",
  "statusCode": 400,
  "title": "Created"
}

DELETE

/subscriptions/{id}

Deletes a subscription

Request Payload

Response Payload

Missing schema or example in the OpenAPI spec.
Update the definition and recreate the mock server.

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://digital-gym.name/",
  "statusCode": 400,
  "title": "Created"
}

Data Request

POST

/subscriptions/{id}/replay

Posting a request to a subscription replay is a request that is not immediately honoured. The replay event will be queued for later execution. This operation is limited to 7 calls per day.

Request Payload

{
  "forDate": "2025-11-02"
}

Response Payload

Missing schema or example in the OpenAPI spec.
Update the definition and recreate the mock server.

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://cooperative-futon.org",
  "statusCode": 201,
  "title": "Accepted"
}

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://heavy-arcade.org",
  "statusCode": 200,
  "title": "Accepted"
}

{
  "detail": "Subscription not found.",
  "instance": "https://respectful-alert.com",
  "statusCode": 200,
  "title": "Not Found"
}

{
  "detail": "Internal service failure.",
  "instance": "https://earnest-switchboard.info/",
  "statusCode": 500,
  "title": "Created"
}

Service Homepage: developer.dhl.com/api-reference/mail-communication-tracking-push-post-parcel-germany#reference-docs-section

dhllogisticstrackingshippingnotifications