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": "4",
    "version": "2.0.9"
  }
}

AppResource(8 operations)

PUT

/app/wallet

Charge users wallet

Query Parameter Name	Example
`amount`*	`1158688331`

Request Payload

Response Payload

{
  "shopOrderId": "UMelg8VGvr",
  "walletBalance": 81232
}

{
  "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": "HSxRta26Oo"
}

{
  "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`	`false`
`directCheckout`	`false`

Request Payload

{
  "createManifest": false,
  "createShippingList": "1",
  "dpi": "DPI203",
  "optimizePNG": true,
  "positions": [
    {
      "address": {
        "receiver": {
          "additionalName": "Wiza and Sons",
          "addressLine1": "455 Post Road",
          "addressLine2": "_",
          "city": "South Ethelshire",
          "country": "CHE",
          "name": "Randall Muller IV",
          "postalCode": "10450"
        },
        "sender": {
          "additionalName": "Roob, Reichel and Price",
          "addressLine1": "796 Keshaun Pike",
          "addressLine2": "Apartment 4B",
          "city": "Lake Marley",
          "country": "AUT",
          "name": "Fredrick Kunde MD",
          "postalCode": "83657"
        }
      },
      "imageID": 67,
      "positionType": "AppShoppingCartPosition",
      "productCode": 456,
      "voucherLayout": "ADDRESS_ZONE"
    }
  ],
  "shopOrderId": "NDTtqVmBsU",
  "total": 5149,
  "type": "AppShoppingCartPNGRequest"
}

Response Payload

{
  "link": "https://clear-cut-tennis.org/",
  "manifestLink": "https://hidden-longboat.info/",
  "shoppingCart": {
    "shopOrderId": "clSzjMnoAm",
    "voucherList": [
      {
        "trackId": "p1UMoo1KZ2mZvfQ",
        "voucherId": "6ea35dc6-5d6a-4098-8d58-aac8e549a206"
      },
      {
        "trackId": "s6dxG9hZFUIZLDX",
        "voucherId": "b9d35ce0-6c1a-4115-ab2c-5166878bdef8"
      },
      {
        "trackId": "nteJY6vzPHK4NvB",
        "voucherId": "838dbb27-0f20-4a94-a9e3-9585753e4afe"
      },
      {
        "trackId": "0sJOFBmPtDiqIhm",
        "voucherId": "13fc83f9-5184-487f-9072-3f51a4f65672"
      },
      {
        "trackId": "X92z8e8j8NecBqe",
        "voucherId": "0fbef855-b256-45ca-b7b7-b974b6884564"
      },
      {
        "trackId": "zX3Sz47iP0jTxic",
        "voucherId": "7efd011f-bac3-4884-9b75-d9f50765bca0"
      },
      {
        "trackId": "Sk6RhanEcZ1nZmT",
        "voucherId": "2fa08b58-bce7-4919-b44b-f209ad39aefc"
      },
      {
        "trackId": "RL5VN0lFyF565St",
        "voucherId": "7aebdc78-041e-4bd6-87b3-475be0284d3a"
      },
      {
        "trackId": "CRd55oMXGmadxbV",
        "voucherId": "c0fe31d8-a5fe-4745-8020-503d5c7ae381"
      },
      {
        "trackId": "yZOxrskr9pKj5i9",
        "voucherId": "f78c8ecb-ad42-49a8-9c45-994c0414c525"
      }
    ]
  },
  "type": "CheckoutResponse",
  "walletBallance": 40838
}

{
  "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`	`false`

Request Payload

{
  "createManifest": true,
  "createShippingList": "2",
  "dpi": "DPI300",
  "pageFormatId": 5,
  "positions": [
    {
      "address": {
        "receiver": {
          "additionalName": "Von - Herzog",
          "addressLine1": "453 Thea Glens",
          "addressLine2": "Suite 200",
          "city": "New Anabelville",
          "country": "AUT",
          "name": "Gladys Torphy",
          "postalCode": "24538"
        },
        "sender": {
          "additionalName": "Heaney - Nicolas",
          "addressLine1": "80726 Janice Rapid",
          "addressLine2": "Apartment 4B",
          "city": "Littletown",
          "country": "CHE",
          "name": "Olga Breitenberg",
          "postalCode": "25007"
        }
      },
      "imageID": 382,
      "position": {
        "labelX": 316,
        "labelY": 297,
        "page": 4
      },
      "positionType": "AppShoppingCartPosition",
      "productCode": 746,
      "voucherLayout": "FRANKING_ZONE"
    },
    {
      "address": {
        "receiver": {
          "additionalName": "Kling - Russel",
          "addressLine1": "548 Bogisich Falls",
          "addressLine2": "-",
          "city": "Adriannacester",
          "country": "CHE",
          "name": "Keith Hyatt",
          "postalCode": "43990"
        },
        "sender": {
          "additionalName": "Hirthe Inc",
          "addressLine1": "2862 Camron Garden",
          "addressLine2": "Suite 200",
          "city": "Palm Springs",
          "country": "DEU",
          "name": "Dr. Sonia Gerhold",
          "postalCode": "65407"
        }
      },
      "imageID": 353,
      "position": {
        "labelX": 389,
        "labelY": 240,
        "page": 4
      },
      "positionType": "AppShoppingCartPosition",
      "productCode": 150,
      "voucherLayout": "ADDRESS_ZONE"
    }
  ],
  "shopOrderId": "2Dj2n6kup4",
  "total": 48264,
  "type": "AppShoppingCartPDFRequest"
}

Response Payload

{
  "link": "https://married-forgery.net/",
  "manifestLink": "https://content-license.info/",
  "shoppingCart": {
    "shopOrderId": "HbFcZG7hnE",
    "voucherList": [
      {
        "trackId": "3TkiqILyoA8uEnc",
        "voucherId": "ac39741b-2314-4c24-acc9-c482c2175d94"
      },
      {
        "trackId": "Z94fz51qBKYLLuj",
        "voucherId": "1d5daa96-a33e-43a2-bbe9-53930513491a"
      },
      {
        "trackId": "NsEz5VbTqT3dvCu",
        "voucherId": "91750440-1876-420a-b222-b46212700f36"
      },
      {
        "trackId": "OGJjqHeddvIozTU",
        "voucherId": "2ce784b2-f3b8-452a-a9d2-52b9f1c0e15c"
      },
      {
        "trackId": "KASXsa3vaWpHWOu",
        "voucherId": "ee39fe38-2c31-4c26-bf58-1397b0d0ea17"
      },
      {
        "trackId": "d5rFPta64RccuFQ",
        "voucherId": "da92843f-8f78-4b67-8ef0-96acafd55b62"
      },
      {
        "trackId": "FoEkkk12NvDWVGx",
        "voucherId": "30137302-b5e5-4fdd-b34d-1293789f7f36"
      },
      {
        "trackId": "studpteifioIN3D",
        "voucherId": "b73446c9-0cbf-4c06-b0b8-3d9b93713e3a"
      },
      {
        "trackId": "QsaY7REtNNZSB2Z",
        "voucherId": "8dc735a0-1598-43d2-a3fa-f3cdf26e74b5"
      },
      {
        "trackId": "00putt1KDhj00Nc",
        "voucherId": "033d6197-c747-4daa-aa52-2fdd7dc770a9"
      }
    ]
  },
  "type": "CheckoutResponse",
  "walletBallance": 94271
}

{
  "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`	`dolore ea commodo`
`retoureTransactionId`	`-897345366`
`startDate`	`1891-08-12T02:44:51.0Z`
`endDate`	`1930-08-07T15:24:54.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": "Qma9uXzdiT",
    "voucherList": [
      {
        "trackId": "DrXktHtlGaujdxu",
        "voucherId": "92cb5ffc-722e-47c7-9600-63cec50c1977"
      },
      {
        "trackId": "Oj6f5LhZebSkr8V",
        "voucherId": "2c070ccd-9185-4d53-9fb3-146eb3e2ca94"
      },
      {
        "trackId": "SDza0ROpxTiZkHe",
        "voucherId": "5cb9b06f-0991-4b53-a5ba-afc32d796891"
      },
      {
        "trackId": "EFF27wk2lXRxHuj",
        "voucherId": "67abe5eb-3429-4597-acf5-f010246e8cbc"
      },
      {
        "trackId": "fx02JiaVSh0txkx",
        "voucherId": "2bf4a61e-3759-4e8b-876e-78de79e21969"
      },
      {
        "trackId": "loYXQJCHKnUBTAb",
        "voucherId": "7f063f51-b903-4035-a01e-b044f65ef44c"
      },
      {
        "trackId": "SCL6wnO2dImpfiS",
        "voucherId": "6327d5a8-750a-4a38-83bd-f9e80e3ef645"
      },
      {
        "trackId": "PYoy49pkAErXQwv",
        "voucherId": "1a93de3e-473f-4780-8936-5f1509da1cad"
      },
      {
        "trackId": "draC8uvUkDgeUEo",
        "voucherId": "35654bd4-5cd4-48fa-8975-e931c01055e2"
      },
      {
        "trackId": "rJJwe8geDOx2MRE",
        "voucherId": "5ee923be-5c29-4067-b453-2f68773ce845"
      }
    ]
  }
}

Response Payload

{
  "retoureTransactionId": "oLoDhUNHr5rV",
  "shopRetoureId": "HgjlxKny"
}

{
  "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`*	`["PUBLIC"]`

Request Payload

Response Payload

{
  "contractProducts": {
    "products": [
      {
        "price": 3985,
        "productCode": 867
      },
      {
        "price": 4207,
        "productCode": 496
      },
      {
        "price": 2126,
        "productCode": 101
      },
      {
        "price": 3242,
        "productCode": 171
      }
    ]
  },
  "pageFormats": [
    {
      "description": "Small business envelope",
      "id": 3,
      "isAddressPossible": false,
      "isImagePossible": false,
      "name": "DIN A4 plain",
      "pageLayout": {
        "labelCount": {
          "labelX": 36,
          "labelY": 247
        },
        "labelSpacing": {
          "x": 69,
          "y": 47.8
        },
        "margin": {
          "bottom": 7.1,
          "left": 4.8,
          "right": 9.2,
          "top": 1.7
        },
        "orientation": "PORTRAIT",
        "size": {
          "x": 105.8,
          "y": 87.5
        }
      },
      "pageType": "LABELPRINTER"
    },
    {
      "description": "Small business envelope",
      "id": 5,
      "isAddressPossible": false,
      "isImagePossible": true,
      "name": "A6 postcard",
      "pageLayout": {
        "labelCount": {
          "labelX": 269,
          "labelY": 254
        },
        "labelSpacing": {
          "x": 75.1,
          "y": 29.6
        },
        "margin": {
          "bottom": 9.8,
          "left": 2.5,
          "right": 3.1,
          "top": 9.7
        },
        "orientation": "PORTRAIT",
        "size": {
          "x": 67.7,
          "y": 169.6
        }
      },
      "pageType": "LABELPAGE"
    },
    {
      "description": "Postcard format",
      "id": 3,
      "isAddressPossible": false,
      "isImagePossible": true,
      "name": "Letter C5",
      "pageLayout": {
        "labelCount": {
          "labelX": 485,
          "labelY": 144
        },
        "labelSpacing": {
          "x": 81,
          "y": 31.4
        },
        "margin": {
          "bottom": 7,
          "left": 3.4,
          "right": 8.3,
          "top": 8.7
        },
        "orientation": "PORTRAIT",
        "size": {
          "x": 96.5,
          "y": 51.6
        }
      },
      "pageType": "REGULARPAGE"
    },
    {
      "description": "Small business envelope",
      "id": 3,
      "isAddressPossible": false,
      "isImagePossible": false,
      "name": "DIN A4 plain",
      "pageLayout": {
        "labelCount": {
          "labelX": 375,
          "labelY": 246
        },
        "labelSpacing": {
          "x": 181.7,
          "y": 135.3
        },
        "margin": {
          "bottom": 1.3,
          "left": 8.7,
          "right": 8.6,
          "top": 2.5
        },
        "orientation": "PORTRAIT",
        "size": {
          "x": 56.2,
          "y": 181.2
        }
      },
      "pageType": "LABELPRINTER"
    },
    {
      "description": "Postcard format",
      "id": 3,
      "isAddressPossible": false,
      "isImagePossible": true,
      "name": "DIN A4 plain",
      "pageLayout": {
        "labelCount": {
          "labelX": 311,
          "labelY": 7
        },
        "labelSpacing": {
          "x": 59.3,
          "y": 42.7
        },
        "margin": {
          "bottom": 8.5,
          "left": 3.2,
          "right": 7.2,
          "top": 9.4
        },
        "orientation": "LANDSCAPE",
        "size": {
          "x": 153.1,
          "y": 140.6
        }
      },
      "pageType": "REGULARPAGE"
    }
  ],
  "privateCatalog": {
    "imageLink": [
      {
        "link": "https://dapper-trick.name/",
        "linkThumbnail": "https://direct-representation.org"
      }
    ]
  },
  "publicCatalog": {
    "items": [
      {
        "category": "Celebrations",
        "categoryDescription": "Modern abstract designs",
        "categoryId": 3,
        "images": [
          {
            "imageDescription": "Flower bouquet",
            "imageID": 500,
            "imageSlogan": "Cutest ever",
            "links": {
              "link": "https://comfortable-spear.com/",
              "linkThumbnail": "https://blond-fat.biz/"
            }
          },
          {
            "imageDescription": "Mountains",
            "imageID": 36,
            "imageSlogan": "Pure nature",
            "links": {
              "link": "https://familiar-foodstuffs.biz/",
              "linkThumbnail": "https://imaginary-fort.org"
            }
          },
          {
            "imageDescription": "Flower bouquet",
            "imageID": 201,
            "imageSlogan": "Breathtaking",
            "links": {
              "link": "https://needy-mountain.org/",
              "linkThumbnail": "https://minty-wallaby.org/"
            }
          },
          {
            "imageDescription": "Flower bouquet",
            "imageID": 346,
            "imageSlogan": "Breathtaking",
            "links": {
              "link": "https://prudent-habit.org/",
              "linkThumbnail": "https://legal-hydrolyse.net"
            }
          },
          {
            "imageDescription": "Sunset at sea",
            "imageID": 381,
            "imageSlogan": "Breathtaking",
            "links": {
              "link": "https://pleasing-nectarine.biz/",
              "linkThumbnail": "https://shocked-premium.org/"
            }
          }
        ]
      },
      {
        "category": "Animals",
        "categoryDescription": "Motifs for celebrations",
        "categoryId": 10,
        "images": [
          {
            "imageDescription": "Minimalist shape",
            "imageID": 425,
            "imageSlogan": "Cutest ever",
            "links": {
              "link": "https://illustrious-newsletter.name/",
              "linkThumbnail": "https://utter-jungle.net"
            }
          },
          {
            "imageDescription": "Minimalist shape",
            "imageID": 467,
            "imageSlogan": "Love it",
            "links": {
              "link": "https://nervous-obesity.org/",
              "linkThumbnail": "https://wrong-replacement.name"
            }
          }
        ]
      }
    ]
  }
}

{
  "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": "bsbFY61dRpjVxsb5HGYtyBvJd4WX9opy",
  "client_secret": "EV4bNJprP0349S70",
  "grant_type": "client_credentials",
  "password": "lvP7mUIXxpks",
  "username": "Orion8@gmail.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