Retrieve Multiple Shipping Labels

Use this endpoint to retrieve a PDF of multiple shipping labels after booking multiple shipments.

REST Endpoint

POST /restapi/v1/customers/:customerId/shipments/multiple/labels/:labelImageFormat

Response Status Code

200 OK

Response Content Type

The reponse content type will depend on the labelImageFormat that was used when the shipment was booked.

If labelImageFormat was PDF (or null), the response content type will be application/pdf.

If labelImageFormat was EPL2, ZPL, or PNG, the response content type will be application/json.

Response JSON Example (EPL2)

{
  "labelImageFormat": "EPL2",
  "base64Images": [
      "....base64 encoded content....",
      "....base64 encoded content...."
  ]
}

Response JSON Example (PNG)

{
  "labelImageFormat": "PNG",
  "base64Images": [
      "....base64 encoded content....",
      "....base64 encoded content...."
  ]
}

PNG Format Support

PNG format is supported for the following carriers: - DHL eCommerce (dhlecommerce)

If PNG format is requested for an unsupported carrier, an error message will be returned.

Explanation of Response Fields

Field Type Description
bookNumbers array IDs for the requested shipments