Page tree
Skip to end of metadata
Go to start of metadata

Warning!

The resource is available only in the following countries: PL, IT

  • Return label generation is available only for courier services (excluding allegro).
  • Shipment label can be downloaded only for already bought shipments - confirmed or later status.

  • Only users that are the shipments sender can download the label.

  • For single parcel shipments a single file is returned in the following format .pdf, .epl/.epl2, .zpl,
  • For multiple shipments:
    - if shipments are the same service one file containing all shipment labels is returned
    - for different services one .zip file containing .epl/.epl2 , .zpl, .pdf files, one for each service is returned
  • maximum number of labels downloaded in one request is 100


On this page

 

Authentication

Access to the resource requires a valid access token.




Return label download

GET /v1/organizations/:organization_id/shipments/return_labels

Parameters

ParameterTypeDescriptionValidationDefault valueAvailability
formatStringLabel formatAvailable formats: Pdf, Epl, Zpl PdfPL, IT
shipment_idsArray[Integer]Shipment identifiers

PL, IT

Example request

curl -X GET "https://api-shipx-pl.easypack24.net/v1/organizations/1/shipments/return_labels?shipment_ids[]=4257802&shipment_ids[]=4257803&format=zpl" -H 'Authorization: Bearer token' -H 'Content-Type: application/json'

Response

file with one of the following formats is returned: .pdf/.epl/.epl2/.zpl/.zip

Error information

Errors that may occur during return label download:

  • label_generation_failed - the label could not be generated, detailed information can be found in the  message and/or details attributes.

  • label_template_not_found - label template could not be found in the system,

  • invalid_action - when trying to download the label for a shipment not yet bought - before confirmed status.



  • No labels