Deliveries

View Delivery Label

View as Markdown

The shipping label is generated at the time of booking and the label_url is returned directly in the Create Delivery response. This endpoint allows you to retrieve the label separately at any time after the delivery has been booked, using either the delivery_id or your own reference.

Endpoint

GET {{domain}}/{{tenant_id}}/deliveries/{{delivery_id_or_reference}}/label

Authentication: Bearer token required via the Authorization header.

Path Parameters

ParameterDescription
delivery_id_or_referenceThe Rendr delivery_id returned when the delivery was created, or your own reference value.

Query Parameters

ParameterTypeDefaultDescription
file_typeStringpdfThe label format to return. Accepted values: pdf, zpl.

Response

Returns the shipping label for the given delivery in the requested format. The default format is PDF.

GET {{domain}}/{{tenant_id}}/deliveries/{{delivery_id_or_reference}}/label?file_type=zpl

The label is only available once a delivery has been booked and a consignment number assigned. Calling this endpoint for a delivery in requested state will return an error.

ZPL Label Support

ZPL (Zebra Programming Language) labels are supported for accounts configured by a Rendr account manager. When enabled, the Create Delivery response will include a label_zpl_url field alongside the standard label_url.

ZPL labels are designed for direct printing on Zebra and compatible thermal label printers without any PDF rendering step, making them well-suited for high-volume fulfilment environments.

To enable ZPL label generation for your account, contact your Rendr account manager.

FieldDescription
label_urlSigned URL to the PDF label. Always returned when a label is available.
label_zpl_urlSigned URL to the ZPL label. Returned only when ZPL is enabled on your account.

Dangerous Goods Declaration Document

For deliveries containing dangerous goods, the carrier may generate a Dangerous Goods Declaration (DGD) document. Rendr automatically retrieves and stores this document, and the signed URL is available in the Create Delivery and Get Delivery responses under dangerous_goods_form_url.

To retrieve the DGD PDF directly:

GET {{domain}}/{{tenant_id}}/deliveries/{{delivery_id_or_reference}}/label/dgd

The DGD document is only present where the carrier generates one. Not all dangerous goods shipments will produce a DGD. See Dangerous Goods for full details on declaring dangerous goods in a delivery.