Get shipping label

GET

/shipping/api/v1/shipments/{id}/label.{format}

• Veeqo API Production Server

Retrieve the shipping label for a booked shipment. Returns either an expiring URL or streams the file directly based on the redirect parameter. Optionally add custom messages to the label.

Parameters

Path Parameters

id

required

string

The remote shipment ID or tracking number

Example

851f578f-2c4d-4e91-8a3b-6f0d7e2c9b51

format

required

string

Allowed values: pdf png zpl jpeg

Label format

Query Parameters

redirect

boolean

If true, returns a 302 redirect to an expiring URL. If false or omitted, streams the file directly.

custom_messages

Array<string>

Array of custom messages to print on the label (e.g., custom_messages[]=MESSAGE1&custom_messages[]=MESSAGE2)

Example

?custom_messages=PDF%20CUSTOM%20MESSAGE%201&custom_messages=PDF%20CUSTOM%20MESSAGE%202

Responses

200

Label file streamed successfully

string format: binary

string format: binary

string

string format: binary

302

Redirect to expiring URL (when redirect=true)

400

Invalid label format

object

error_messages

required

List of error messages

Array<string>

[
  "to_address is required"
]

{
  "error_messages": [
    "Invalid request parameters"
  ]
}

404

Shipment or label not found

object

error_messages

required

List of error messages

Array<string>

[
  "to_address is required"
]

{
  "error_messages": [
    "Invalid request parameters"
  ]
}