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": "Subscription not found.",
  "instance": "https://eminent-understanding.biz/",
  "statusCode": 401,
  "title": "Internal Server Error"
}

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://astonishing-antelope.biz/",
  "email": "Gia_Armstrong@gmail.com",
  "exportFormat": "application/json",
  "id": "4f1de1a7-25b2-46bd-981b-67cd4f0926fc",
  "language": "en",
  "numberOfRecords": 373,
  "validationCallbackURL": "https://somber-freezing.org/"
}

Response Payload

{
  "dataCallbackURL": "https://right-distinction.com/",
  "email": "Kacie.Johnston60@gmail.com",
  "exportFormat": "application/json",
  "id": "c5535611-6b5a-4781-aaa5-3329b3aac0d3",
  "language": "de",
  "numberOfRecords": 23,
  "validationCallbackURL": "https://steel-possession.net/"
}

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://runny-platter.com/",
  "statusCode": 403,
  "title": "Bad Request"
}

{
  "detail": "Subscription not found.",
  "instance": "https://thick-fuel.org/",
  "statusCode": 500,
  "title": "Accepted"
}

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://impartial-pacemaker.name/",
  "statusCode": 500,
  "title": "Bad Request"
}

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": "mhUntRSU6UcotgqyhFs9ooEOKzwTBuTBzvV08H6RXQ5uLq7gVoybZzR1MzxRUo2u"
}

Response Payload

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

{
  "detail": "Invalid request format.",
  "instance": "https://exalted-pigpen.com/",
  "statusCode": 500,
  "title": "OK"
}

{
  "detail": "Invalid request format.",
  "instance": "https://supportive-seal.org",
  "statusCode": 400,
  "title": "Created"
}

{
  "detail": "Internal service failure.",
  "instance": "https://interesting-numeracy.net/",
  "statusCode": 500,
  "title": "Accepted"
}

Subscription Management(4 operations)

GET

/subscriptions

All subscriptions of a user

Request Payload

Response Payload

[
  {
    "dataCallbackURL": "https://willing-hepatitis.info",
    "email": "Carey43@hotmail.com",
    "exportFormat": "application/json",
    "id": "22ede687-cbea-47c4-9cc8-cb0a115bde4a",
    "language": "de",
    "numberOfRecords": 280,
    "validationCallbackURL": "https://nutritious-brush.org"
  },
  {
    "dataCallbackURL": "https://aching-coliseum.info",
    "email": "Makenna_Grimes82@gmail.com",
    "exportFormat": "application/json",
    "id": "b9ce3646-c0e9-4960-ada5-121ce8dd0ee3",
    "language": "de",
    "numberOfRecords": 139,
    "validationCallbackURL": "https://complete-scrap.com/"
  }
]

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://tasty-partridge.info/",
  "statusCode": 202,
  "title": "Accepted"
}

{
  "detail": "Subscription not found.",
  "instance": "https://expert-airline.com",
  "statusCode": 403,
  "title": "Bad Request"
}

GET

/subscriptions/{id}

Gets a push subscription by its id

Request Payload

Response Payload

{
  "dataCallbackURL": "https://total-breastplate.biz/",
  "email": "Aaron42@hotmail.com",
  "exportFormat": "application/xml",
  "id": "aadc6e12-c8d2-4b9b-94ae-f3a8bf2fe3ad",
  "language": "en",
  "numberOfRecords": 344,
  "validationCallbackURL": "https://tiny-hexagon.org"
}

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://lovable-volleyball.org",
  "statusCode": 202,
  "title": "Bad Request"
}

{
  "detail": "Subscription not found.",
  "instance": "https://oblong-larva.biz/",
  "statusCode": 401,
  "title": "Accepted"
}

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://pertinent-agreement.biz",
  "statusCode": 500,
  "title": "Internal Server Error"
}

PUT

/subscriptions/{id}

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

Request Payload

{
  "email": "Kirsten.Mitchell72@hotmail.com",
  "exportFormat": "application/xml",
  "language": "en",
  "numberOfRecords": 45
}

Response Payload

{
  "dataCallbackURL": "https://bare-alliance.biz/",
  "email": "Darren_Konopelski@yahoo.com",
  "exportFormat": "application/json",
  "id": "dce7a7d2-e359-4017-bd80-25a151acf7b4",
  "language": "de",
  "numberOfRecords": 480,
  "validationCallbackURL": "https://all-scratch.com/"
}

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://appropriate-jazz.biz",
  "statusCode": 404,
  "title": "Bad Request"
}

{
  "detail": "Invalid request format.",
  "instance": "https://unlawful-numeracy.com",
  "statusCode": 403,
  "title": "Bad Request"
}

{
  "detail": "Internal service failure.",
  "instance": "https://well-groomed-hubris.org",
  "statusCode": 200,
  "title": "OK"
}

{
  "detail": "Internal service failure.",
  "instance": "https://frank-lieu.info/",
  "statusCode": 403,
  "title": "Accepted"
}

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": "Subscription not found.",
  "instance": "https://nautical-hygienic.com/",
  "statusCode": 401,
  "title": "Accepted"
}

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": "2026-05-13"
}

Response Payload

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

{
  "detail": "Unauthorized access attempt.",
  "instance": "https://dim-boulevard.org/",
  "statusCode": 500,
  "title": "Not Found"
}

{
  "detail": "Invalid request format.",
  "instance": "https://paltry-reasoning.info",
  "statusCode": 500,
  "title": "Bad Request"
}

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://pleasing-affect.name",
  "statusCode": 500,
  "title": "OK"
}

{
  "detail": "The Webservice call ran successfully.",
  "instance": "https://definitive-sock.org/",
  "statusCode": 201,
  "title": "OK"
}

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

dhllogisticstrackingshippingnotifications