Skip to main content


About 1 min



Get shipment labels in the requested format.


  • Method: GET
  • Content Type: application/json
  • URL:


  • access_key : your unqiue api key provided by GSS.
  • site_id : which site you are requesting action for.


The body of the message should be sent as an Json object.

formatstring optional - available formats are as below. If not supplied, the default is LABEL_PNG_100X175 The 100x150 sizing is presently experimental and not available across all carriers
LABEL_PDFlabel is presented on an A4 page
LABEL_PNG_100X175label is presented as a PNG image with dimension 100mm x 175mm
LABEL_PNG_100X150label is presented as a PNG image with dimension 100mm x 150mm
LABEL_PDF_100X175label is presented as a PDF with dimension 100mm x 175mm
LABEL_PDF_100X150label is presented as a PDF with dimension 100mm x 150mm
LABEL_PDF_LABELOPElabel is presented as a PDF Labelope. Rotation is not supported
USER_CONFIGUREDlabel is presented as a PDF when User's Printing Setting is PDF file, or a PRN file is presented if User's Printing Setting is GoPrint - PRN Download
GOPRINT_PRNPRN file is presented
rotatebooleanoptional - if the label orientation requires 180 degree rotation
connotestringshipment consignment number to download

Return format

An array of base64 encoded binary:

  • In the case of multi part shipments, the PNG format will return a binary block per part.
  • In the case of PDF, all parts are returned on a single multi page pdf.

Request example

curl --location '' \
--header 'access_key;' \
--header 'site_id;' \
--header 'Content-Type: application/json'

Response example

Binary blocks below have been trimmed for presentation.

Last update: