Deutsche Post INTERNETMARKE Virtual Sandbox

Automate online postage generation and mail product management for Deutsche Post.

The INTERNETMARKE API allows developers to integrate Deutsche Post's online postage services directly into their applications. It supports managing shopping carts, generating postage labels in various formats like PNG and PDF, and handling user-specific postage configurations for mail products.

Use this hosted sandbox to simulate Deutsche Post INTERNETMARKE 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 postage label generation workflows, shopping cart management, wallet balance checks, and PDF/PNG rendering logic. Developers can simulate successful label creation, handle order retrieval by ID, and test error responses for invalid mail product configurations before integrating with production postage services.

Deutsche Post INTERNETMARKE virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate Deutsche Post INTERNETMARKE responses instantly.

`https://dhl-internetmarke.mock.beeceptor.com`

ApiVersionResource

GET

/

The call can be used to obtain the current version of the API and to confirm that the API is operational. Note that this call does not require authentication, it can also be called via browser.

Request Payload

Response Payload

{
  "amp": {
    "env": "prod-eu",
    "name": "pp-post-internetmarke",
    "rev": "6",
    "version": "3.0.16"
  }
}

AppResource(8 operations)

PUT

/app/wallet

Charge users wallet

Query Parameter Name	Example
`amount`*	`1138685042`

Request Payload

Response Payload

{
  "shopOrderId": "uCUOmRTN0Y",
  "walletBalance": 983
}

{
  "statusCode": "400",
  "title": "Bad Request",
  "detail": "Required request header 'Authorization' for method parameter type String is not present"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "403",
  "title": "Forbidden",
  "detail": "Forbidden, user has not enough privileges to perform this request."
}

{
  "statusCode": "404",
  "title": "Not Found",
  "detail": "Wallet not found for account: ACCOUNT12345"
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

POST

/app/shoppingcart

Initializes a shopping cart and returns the shopOrderId.

Request Payload

Response Payload

{
  "shopOrderId": "0nWrqtwE9e"
}

{
  "statusCode": "400",
  "title": "Bad Request",
  "detail": "Required request header 'Authorization' for method parameter type String is not present"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "403",
  "title": "Forbidden",
  "detail": "Forbidden, user has not enough privileges to perform this request."
}

{
  "statusCode": "404",
  "title": "Not Found",
  "detail": "Order not found: ORDERID12345"
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

POST

/app/shoppingcart/png

Checkouts the PNG shopping cart. Be aware of the different types of schemas for checkout OR preview within the request. Preview does not need addresses. The print format is not relevant at this point.

Query Parameter Name	Example
`validate`	`true`
`directCheckout`	`true`

Request Payload

{
  "createManifest": false,
  "createShippingList": "1",
  "dpi": "DPI300",
  "optimizePNG": true,
  "positions": [
    {
      "address": {
        "receiver": {
          "additionalName": "Blick and Sons",
          "addressLine1": "265 N East Street",
          "addressLine2": "Apartment 4B",
          "city": "Lilyboro",
          "country": "CHE",
          "name": "Willie Zieme Sr.",
          "postalCode": "91530"
        },
        "sender": {
          "additionalName": "Padberg, Bins and Koepp",
          "addressLine1": "5522 Koelpin Island",
          "addressLine2": "3rd Floor",
          "city": "Aufderharborough",
          "country": "AUT",
          "name": "Mrs. Norma Hackett",
          "postalCode": "29431"
        }
      },
      "imageID": 431,
      "positionType": "AppShoppingCartPosition",
      "productCode": 216,
      "voucherLayout": "FRANKING_ZONE"
    }
  ],
  "shopOrderId": "dPuGTzsm5W",
  "total": 35686,
  "type": "AppShoppingCartPNGRequest"
}

Response Payload

{
  "link": "https://guilty-travel.name/",
  "manifestLink": "https://unconscious-overcoat.info",
  "shoppingCart": {
    "shopOrderId": "tIa8X2Z8xz",
    "voucherList": [
      {
        "trackId": "VthgDmtUdpV9ndA",
        "voucherId": "cc9c017e-dd6b-422f-9569-9b79838e2106"
      },
      {
        "trackId": "oFURVCcyFJMDiEs",
        "voucherId": "10f46c6f-c5f6-4831-9dfd-c8d2ab1e529e"
      },
      {
        "trackId": "ORmeo9uxJXM0Urq",
        "voucherId": "7c0f665a-346a-4881-8094-f8bb10056770"
      },
      {
        "trackId": "s17J58jOXyFBBHU",
        "voucherId": "988d9261-94e1-4a0c-a131-41e0f90501eb"
      },
      {
        "trackId": "YKkynXXfeGrDkZL",
        "voucherId": "47b7fcf2-567f-4592-8fbf-94cc434e2f8c"
      },
      {
        "trackId": "DThhJYGe90ovpsF",
        "voucherId": "a821222d-3b10-40bf-8b27-2e0aa1a6e732"
      },
      {
        "trackId": "wCpV62YW6QiNrZ7",
        "voucherId": "ac93731e-84c8-4d8b-b857-ab8d4ba63a4c"
      },
      {
        "trackId": "dJWvVKgOU6tiPF9",
        "voucherId": "24bcf1ab-9176-4dad-9d23-e2469a7c1277"
      },
      {
        "trackId": "ipxMZCWNJMOiGgv",
        "voucherId": "481ebd48-78ac-46c0-a434-769b8112532f"
      },
      {
        "trackId": "50mDGoeIsUqE6hO",
        "voucherId": "9869c03d-e06f-45b7-a5a5-b85a81117e34"
      }
    ]
  },
  "type": "CheckoutResponse",
  "walletBallance": 79878
}

{
  "statusCode": "400",
  "title": "Bad Request",
  "detail": "Required request header 'Authorization' for method parameter type String is not present"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "403",
  "title": "Forbidden",
  "detail": "Forbidden, user has not enough privileges to perform this request."
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

POST

/app/shoppingcart/pdf

Checkouts the PDF shopping cart. Be aware of the different types of schemas for checkout OR preview within the request. Preview does not need addresses.

Query Parameter Name	Example
`validate`	`false`
`directCheckout`	`true`

Request Payload

{
  "createManifest": false,
  "createShippingList": "1",
  "dpi": "DPI203",
  "pageFormatId": 3,
  "positions": [
    {
      "address": {
        "receiver": {
          "additionalName": "Grant, Langworth and Luettgen",
          "addressLine1": "359 Beech Grove",
          "addressLine2": "3rd Floor",
          "city": "West Haskellworth",
          "country": "DEU",
          "name": "Percy Emmerich III",
          "postalCode": "08783"
        },
        "sender": {
          "additionalName": "Mante - Schroeder",
          "addressLine1": "28150 4th Avenue",
          "addressLine2": "3rd Floor",
          "city": "Lake Trentonland",
          "country": "DEU",
          "name": "Wade Powlowski",
          "postalCode": "85985"
        }
      },
      "imageID": 452,
      "position": {
        "labelX": 125,
        "labelY": 417,
        "page": 5
      },
      "positionType": "AppShoppingCartPosition",
      "productCode": 424,
      "voucherLayout": "ADDRESS_ZONE"
    },
    {
      "address": {
        "receiver": {
          "additionalName": "Dickens, Hagenes and Kihn",
          "addressLine1": "5373 Earline Path",
          "addressLine2": "Apartment 4B",
          "city": "West Margarete",
          "country": "DEU",
          "name": "Kara Kovacek",
          "postalCode": "06595"
        },
        "sender": {
          "additionalName": "Herzog - Torphy",
          "addressLine1": "83466 Bruen Estates",
          "addressLine2": "=",
          "city": "East Evangeline",
          "country": "DEU",
          "name": "Daniel Kuvalis",
          "postalCode": "97369"
        }
      },
      "imageID": 305,
      "position": {
        "labelX": 332,
        "labelY": 122,
        "page": 9
      },
      "positionType": "AppShoppingCartPosition",
      "productCode": 705,
      "voucherLayout": "ADDRESS_ZONE"
    }
  ],
  "shopOrderId": "mj6a1NOJFR",
  "total": 359,
  "type": "AppShoppingCartPDFRequest"
}

Response Payload

{
  "link": "https://short-filter.net",
  "manifestLink": "https://handy-guacamole.name",
  "shoppingCart": {
    "shopOrderId": "G4vzA3bn1F",
    "voucherList": [
      {
        "trackId": "Mt8ZpPTEQBoC1gR",
        "voucherId": "f9f960cd-1cb8-47e7-ba47-d7cd916c4b5c"
      },
      {
        "trackId": "sOeRzKHgRp2zE29",
        "voucherId": "9321f2ee-50fc-4908-aca0-6bcfe30c73e2"
      },
      {
        "trackId": "mxhUlpF7sCw742H",
        "voucherId": "dc83cc02-2cce-471a-aa63-66a895a061d3"
      },
      {
        "trackId": "De3GMtPK1XvgooP",
        "voucherId": "e8e65c88-963f-4f88-834a-9e233d6036b3"
      },
      {
        "trackId": "mubqIhkh73SJdzo",
        "voucherId": "5814a72c-cfd2-4424-82ff-34abc0e2d129"
      },
      {
        "trackId": "dT8p0VEAi3q15f6",
        "voucherId": "7af41ae7-3891-4c5c-9d41-69c97b68dc65"
      },
      {
        "trackId": "YRv78Djd5hkU8mW",
        "voucherId": "5616904a-f41c-4fa1-9338-b196a705ac00"
      },
      {
        "trackId": "6rmE60Vxor0RPmy",
        "voucherId": "ec92d916-1e60-43cd-a2ee-1570601223b5"
      },
      {
        "trackId": "jcgAato3ra4kDhe",
        "voucherId": "27d77e9c-0db5-4fca-bd51-a39df6dfee2d"
      },
      {
        "trackId": "lo5sAPVOmfjxcXY",
        "voucherId": "bebb4f1c-9206-412a-a4ee-545be253e812"
      }
    ]
  },
  "type": "CheckoutResponse",
  "walletBallance": 22286
}

{
  "statusCode": "400",
  "title": "Bad Request",
  "detail": "Required request header 'Authorization' for method parameter type String is not present"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "403",
  "title": "Forbidden",
  "detail": "Forbidden, user has not enough privileges to perform this request."
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

GET

/app/retoure

Retrieve retoure state for ordered items corresponding to shopRetoureId or retoureTransactionId

Query Parameter Name	Example
`shopRetoureId`	`in aliquip`
`retoureTransactionId`	`-1193558259`
`startDate`	`1957-10-05T21:01:25.0Z`
`endDate`	`1966-04-15T23:58:03.0Z`

Request Payload

Response Payload

{
  "RetrieveRetoureStateResponse": [
    {
      "retoureTransactionId": 15242129,
      "shopRetoureId": "17288644",
      "totalCount": 1,
      "countStillOpen": 0,
      "retourePrice": 95,
      "creationDate": "6102025-190339",
      "serialnumber": "AF188FFFFF",
      "refundedVouchers": [
        {
          "voucherId": "AF188FFFFF0000004F0B",
          "trackId": ""
        }
      ],
      "notRefundedVouchers": [
        {
          "voucherId": "AF188FFFFF0000005F0E",
          "trackId": "AF188FFFEE0000005F0E"
        }
      ]
    }
  ]
}

{
  "statusCode": "400",
  "title": "unknownShopOrderId",
  "detail": "Queued order duplicated for the shopOrderId '123123'"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "403",
  "title": "Forbidden",
  "detail": "Forbidden, user has not enough privileges to perform this request."
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

POST

/app/retoure

Request retoure for ordered items corresponding to all items for shopOrderId or items with specific voucherId or trackId

Request Payload

{
  "shoppingCart": {
    "shopOrderId": "C0ZgbRaWgr",
    "voucherList": [
      {
        "trackId": "RRLKeWj50CKkgxX",
        "voucherId": "4a376569-d646-45f6-89b5-2bb0dccfe4d7"
      },
      {
        "trackId": "n1xQ3oJX8uV7z5D",
        "voucherId": "5f3e0eef-7f0d-4457-854e-f780d4db86f6"
      },
      {
        "trackId": "6O0FvxZshV6VkI6",
        "voucherId": "b3aa321d-e731-4266-88de-d7812ff1a478"
      },
      {
        "trackId": "fP9kRYTXijRf5JP",
        "voucherId": "425506e3-9b42-4268-a940-0e3240328aa1"
      },
      {
        "trackId": "o5E3UioLu1FPoqW",
        "voucherId": "1d45ae3a-5a5c-40e1-b0f9-cc6e60bf7e67"
      },
      {
        "trackId": "ZrcZDe37bCET7ry",
        "voucherId": "3dc5c353-cd3a-470c-a671-7b24c95d6ace"
      },
      {
        "trackId": "Mr4es0Grj3f3EYC",
        "voucherId": "5b30dd14-1e6a-4e80-a2c3-ea734bc967c7"
      },
      {
        "trackId": "QQhLal55MeZlPez",
        "voucherId": "291e9fc3-0009-4431-84c0-f31096ae3ea9"
      },
      {
        "trackId": "W6PNIHu9PkPbYkL",
        "voucherId": "f0bcbb12-3bd1-46b9-8cf1-946ac19c9147"
      },
      {
        "trackId": "tS9Fs1z4AJ6OA2u",
        "voucherId": "8c998564-792f-4657-b243-cc4b3380de1c"
      }
    ]
  }
}

Response Payload

{
  "retoureTransactionId": "nVETthPWRFW4",
  "shopRetoureId": "IR0xZ6B9"
}

{
  "statusCode": "400",
  "title": "Bad Request",
  "detail": "Required request header 'Authorization' for method parameter type String is not present"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "403",
  "title": "Forbidden",
  "detail": "Forbidden, user has not enough privileges to perform this request."
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

GET

/app/shoppingcart/{shopOrderId}

Retrieves a shopping cart.

Request Payload

Response Payload

{
  "type": "CheckoutShoppingCartAppResponse",
  "link": "https://pcf-next.tcb.deutschepost.de/PcfExtensionWeb/document?keyphase=3&data=GpyUVLv5OfMWrV0KlUyeqIusHgvB9sO7BZ5Sh9m%2FZnI%3D",
  "manifestLink": "",
  "shoppingCart": {
    "shopOrderId": "98276337",
    "voucherList": [
      {
        "voucherId": "A00123C0390000000138",
        "trackId": ""
      }
    ]
  },
  "walletBallance": 42355
}

{
  "statusCode": "400",
  "title": "invalidShopOrderID",
  "detail": "Queued order duplicated for the shopOrderId '123123'"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "403",
  "title": "Forbidden",
  "detail": "Forbidden, user has not enough privileges to perform this request."
}

{
  "statusCode": "404",
  "title": "Not Found",
  "detail": "Order not found: ORDERID12345"
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

GET

/app/catalog

Retrieve catalogs.

Query Parameter Name	Example
`types`*	`["PAGE_FORMATS","PUBLIC","PUBLIC","PAGE_FORMATS","PAGE_FORMATS"]`

Request Payload

Response Payload

{
  "contractProducts": {
    "products": [
      {
        "price": 3381,
        "productCode": 372
      },
      {
        "price": 3249,
        "productCode": 965
      },
      {
        "price": 2569,
        "productCode": 371
      }
    ]
  },
  "pageFormats": [
    {
      "description": "Small business envelope",
      "id": 1,
      "isAddressPossible": true,
      "isImagePossible": true,
      "name": "DIN A4 plain",
      "pageLayout": {
        "labelCount": {
          "labelX": 321,
          "labelY": 310
        },
        "labelSpacing": {
          "x": 79.6,
          "y": 182.8
        },
        "margin": {
          "bottom": 0.2,
          "left": 9.2,
          "right": 3.5,
          "top": 4.7
        },
        "orientation": "PORTRAIT",
        "size": {
          "x": 57.4,
          "y": 138.2
        }
      },
      "pageType": "ENVELOPE"
    },
    {
      "description": "Small business envelope",
      "id": 3,
      "isAddressPossible": false,
      "isImagePossible": false,
      "name": "Letter C5",
      "pageLayout": {
        "labelCount": {
          "labelX": 467,
          "labelY": 418
        },
        "labelSpacing": {
          "x": 102,
          "y": 86.1
        },
        "margin": {
          "bottom": 7.5,
          "left": 2.4,
          "right": 5.2,
          "top": 1.6
        },
        "orientation": "LANDSCAPE",
        "size": {
          "x": 169.3,
          "y": 39.5
        }
      },
      "pageType": "ENVELOPE"
    }
  ],
  "privateCatalog": {
    "imageLink": [
      {
        "link": "https://lustrous-cantaloupe.net",
        "linkThumbnail": "https://productive-bookcase.info/"
      },
      {
        "link": "https://nervous-median.org",
        "linkThumbnail": "https://faint-maestro.biz"
      },
      {
        "link": "https://exotic-hierarchy.com/",
        "linkThumbnail": "https://impassioned-angle.name"
      }
    ]
  },
  "publicCatalog": {
    "items": [
      {
        "category": "Celebrations",
        "categoryDescription": "Motifs for holidays",
        "categoryId": 7,
        "images": [
          {
            "imageDescription": "Flower bouquet",
            "imageID": 47,
            "imageSlogan": "Love it",
            "links": {
              "link": "https://reasonable-scorpion.com",
              "linkThumbnail": "https://surprised-minority.info/"
            }
          },
          {
            "imageDescription": "Sunset at sea",
            "imageID": 412,
            "imageSlogan": "Pure nature",
            "links": {
              "link": "https://apprehensive-cemetery.biz/",
              "linkThumbnail": "https://crazy-horde.org/"
            }
          },
          {
            "imageDescription": "Flower bouquet",
            "imageID": 23,
            "imageSlogan": "Cutest ever",
            "links": {
              "link": "https://secret-cellar.name/",
              "linkThumbnail": "https://superb-issue.name"
            }
          },
          {
            "imageDescription": "Mountains",
            "imageID": 238,
            "imageSlogan": "Pure nature",
            "links": {
              "link": "https://jam-packed-divine.biz/",
              "linkThumbnail": "https://golden-maintainer.org"
            }
          },
          {
            "imageDescription": "Sunset at sea",
            "imageID": 395,
            "imageSlogan": "Breathtaking",
            "links": {
              "link": "https://amused-secrecy.com/",
              "linkThumbnail": "https://sorrowful-harp.info/"
            }
          }
        ]
      }
    ]
  }
}

{
  "statusCode": "400",
  "title": "Bad Request",
  "detail": "Required request header 'Authorization' for method parameter type String is not present"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "403",
  "title": "Forbidden",
  "detail": "Forbidden, user has not enough privileges to perform this request."
}

{
  "statusCode": "404",
  "title": "Not Found",
  "detail": "Catalog not found: CATALOG12345"
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

UserResource(2 operations)

POST

/user

__This request is the precondition for almost all other calls!__ The call provides you with the Bearer token which is then used for all other calls. Here is how: The client makes a POST request to the 'user' resource by adding the following parameters using the application/x-www-form-urlencoded

Request Payload

{
  "client_id": "qYLnjYbztLMIWBQoyAvyjJyJmRAbjGzT",
  "client_secret": "ngSSkdB5N9CPGTHF",
  "grant_type": "client_credentials",
  "password": "r14aIGNPi89D",
  "username": "Bruce8@yahoo.com"
}

Response Payload

{
  "access_token": "BnN6L2SeyMjKcIMGhgaaUO6GNAIMBtdqmG7klJKbcIo=",
  "walletBalance": 2446814,
  "infoMessage": "",
  "token_type": "BearerToken",
  "expires_in": 3000,
  "issued_at": "Wed, 03 Apr 2024 08:37:17 GMT",
  "external_customer_id": "DHL-0123",
  "authenticated_user": "max.mustermann@deutschepost.de"
}

{
  "statusCode": "400",
  "title": "Bad Request",
  "detail": "Required request header 'Authorization' for method parameter type String is not present"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

GET

/user/profile

The client retrieves certain settings about his user profile.

Request Payload

Response Payload

{
  "ekp": "6123456789",
  "company": "Deutsche Post AG - TCB",
  "title": "",
  "invoiceType": "ONLINE",
  "invoiceFrequency": "DAILY",
  "mail": "max.mustermann@deutschepost.de",
  "firstname": "Max",
  "lastname": "Mustermann",
  "street": "Hauptstrasse",
  "houseNo": "5",
  "zip": "33602",
  "city": "Teststadt",
  "country": "DEU",
  "phone": "01234567890122",
  "pobox": "4711",
  "poboxZip": "51119",
  "poboxCity": "Bonn"
}

{
  "statusCode": "400",
  "title": "Bad Request",
  "detail": "Required request header 'Authorization' for method parameter type String is not present"
}

{
  "statusCode": "401",
  "title": "Unauthorized",
  "detail": "Unauthorized, user account is not valid, is locked, the provided authorization token is not valid or the application is not authorized by user."
}

{
  "statusCode": "429",
  "title": "Too Many Requests",
  "detail": "Too many requests sent, please try again later.)"
}

{
  "statusCode": "500",
  "title": "Internal Server Error",
  "detail": "Internal Server Error, details about the technical error are provided in the response body. Please contact support if the issue persists."
}

Service Homepage: developer.dhl.com/api-reference/deutsche-post-internetmarke-post-parcel-germany#reference-docs-section

dhlpostageshippinglogisticsecommerce