View DHL Services

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)

Request Payload
Response Payload
-----BEGIN CERTIFICATE----- <CERTIFICATE CONTENT> -----END CERTIFICATE-----

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://dual-league.info/",
  "statusCode": 404,
  "title": "Internal Server Error"
}
Request Payload
{
  "dataCallbackURL": "https://important-farmer.biz",
  "email": "Nat_Kiehn11@yahoo.com",
  "exportFormat": "application/xml",
  "id": "b0a5f0ed-7d88-4724-9638-550558c42445",
  "language": "en",
  "numberOfRecords": 274,
  "validationCallbackURL": "https://rough-fencing.name"
}
Response Payload
{
  "dataCallbackURL": "https://hungry-newsstand.name",
  "email": "Desiree_Nienow@yahoo.com",
  "exportFormat": "application/xml",
  "id": "a0c5fa6d-0b16-4025-a4a1-84c5c0e283a3",
  "language": "de",
  "numberOfRecords": 277,
  "validationCallbackURL": "https://steel-chapel.net"
}
{
  "detail": "Unauthorized access attempt.",
  "instance": "https://trusty-tuba.net/",
  "statusCode": 500,
  "title": "Accepted"
}
{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://impure-litter.info/",
  "statusCode": 400,
  "title": "Bad Request"
}
{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://cumbersome-mythology.info",
  "statusCode": 404,
  "title": "Accepted"
}
Request Payload
{
  "signature": "y8N5L1fflatEigHmPom6kEz00gP9ndZdgbd7rv1UFOfPWI6zAbonjsJpQyjc33aS"
}
Response Payload
Missing schema or example in the OpenAPI spec.
Update the definition and recreate the mock server.
{
  "detail": "Internal service failure.",
  "instance": "https://old-fashioned-pepper.name",
  "statusCode": 403,
  "title": "Bad Request"
}
{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://pleasant-ribbon.name",
  "statusCode": 201,
  "title": "Not Found"
}
{
  "detail": "Invalid request format.",
  "instance": "https://definitive-dredger.com",
  "statusCode": 404,
  "title": "Created"
}

Subscription Management(4 operations)

Request Payload
Response Payload
[
  {
    "dataCallbackURL": "https://unlawful-postbox.name",
    "email": "Arianna.Windler52@yahoo.com",
    "exportFormat": "application/xml",
    "id": "e7689a0e-00db-4b00-b2e0-2f7bfb64c190",
    "language": "en",
    "numberOfRecords": 272,
    "validationCallbackURL": "https://ill-scaffold.name"
  },
  {
    "dataCallbackURL": "https://criminal-embossing.biz",
    "email": "Erik52@yahoo.com",
    "exportFormat": "application/xml",
    "id": "48d5035e-09d5-4f5a-97ca-79f6889574dd",
    "language": "de",
    "numberOfRecords": 303,
    "validationCallbackURL": "https://quick-sauerkraut.name/"
  },
  {
    "dataCallbackURL": "https://judicious-gradient.info",
    "email": "Warren_Beahan@hotmail.com",
    "exportFormat": "application/xml",
    "id": "ec93bbfd-4c06-4e63-957a-3deb5dc19899",
    "language": "en",
    "numberOfRecords": 386,
    "validationCallbackURL": "https://infinite-issue.net"
  }
]
{
  "detail": "Subscription not found.",
  "instance": "https://granular-nerve.com",
  "statusCode": 500,
  "title": "Not Found"
}
{
  "detail": "Subscription not found.",
  "instance": "https://delirious-tribe.net/",
  "statusCode": 401,
  "title": "OK"
}
Request Payload
Response Payload
{
  "dataCallbackURL": "https://each-laughter.info",
  "email": "Rosetta_Swift@yahoo.com",
  "exportFormat": "application/json",
  "id": "086c5a8e-4ccb-4de4-a5e8-ceab39262371",
  "language": "en",
  "numberOfRecords": 245,
  "validationCallbackURL": "https://other-vibraphone.org"
}
{
  "detail": "Subscription not found.",
  "instance": "https://immediate-cappelletti.org",
  "statusCode": 400,
  "title": "Bad Request"
}
{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://chilly-prohibition.biz/",
  "statusCode": 201,
  "title": "Created"
}
{
  "detail": "Subscription not found.",
  "instance": "https://talkative-obligation.name/",
  "statusCode": 401,
  "title": "Bad Request"
}
Request Payload
{
  "email": "Roger31@hotmail.com",
  "exportFormat": "application/json",
  "language": "de",
  "numberOfRecords": 11
}
Response Payload
{
  "dataCallbackURL": "https://rapid-goat.biz",
  "email": "Asha_Cole@hotmail.com",
  "exportFormat": "application/xml",
  "id": "ed27ea3d-81b5-4014-baec-1f95188176d8",
  "language": "en",
  "numberOfRecords": 271,
  "validationCallbackURL": "https://candid-sermon.org/"
}
{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://well-lit-bookcase.com",
  "statusCode": 201,
  "title": "Accepted"
}
{
  "detail": "Internal service failure.",
  "instance": "https://empty-earth.org/",
  "statusCode": 201,
  "title": "Created"
}
{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://troubled-conversation.biz",
  "statusCode": 202,
  "title": "OK"
}
{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://elastic-tectonics.net",
  "statusCode": 401,
  "title": "Not Found"
}
Request Payload
Response Payload
Missing schema or example in the OpenAPI spec.
Update the definition and recreate the mock server.
{
  "detail": "Invalid request format.",
  "instance": "https://bustling-cardboard.name/",
  "statusCode": 200,
  "title": "Internal Server Error"
}

Data Request

Request Payload
{
  "forDate": "2026-01-15"
}
Response Payload
Missing schema or example in the OpenAPI spec.
Update the definition and recreate the mock server.
{
  "detail": "Invalid request format.",
  "instance": "https://different-lady.name",
  "statusCode": 404,
  "title": "Internal Server Error"
}
{
  "detail": "Invalid request format.",
  "instance": "https://bleak-gymnast.biz",
  "statusCode": 404,
  "title": "Bad Request"
}
{
  "detail": "Internal service failure.",
  "instance": "https://diligent-hydrolyse.biz",
  "statusCode": 200,
  "title": "OK"
}
{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://sparse-volleyball.com",
  "statusCode": 403,
  "title": "OK"
}
Service Homepage: developer.dhl.com/api-reference/mail-communication-tracking-push-post-parcel-germany#reference-docs-section
dhllogisticstrackingshippingnotifications