# Get a shipping label

Get an existing shipping label

Endpoint: GET /shipping_labels
Version: 1.4.2
Security: bearerAuth

## Query parameters:

  - `client_shipment_id` (string, required)
    ID of the shipment assigned by the merchant
    Example: "SHP123"

  - `shopCode` (string)
    Shop code which belongs the shipping label. In case this field is not informed, it will be obtained from security context. In case it is informed, it will be validated against the security context
    Example: "marchelacolombine"

## Response 200 fields (application/json):

  - `carrierCode` (string)
    Carrier code associated to the shipment
    Example: "ups"

  - `carrierExternalCode` (string)
    External carrier code associated to the shipment
    Example: 20000008

  - `carrierServiceCode` (string)
    Carrier service associated to the shipment
    Example: "IF-UPS-EXPRESS-SAVER"

  - `clientShipmentId` (string)
    ID of the shipment assigned by the merchant
    Example: "SHP123"

  - `shippingLabels` (array)
    List of shipping labels

  - `shippingLabels.carrierTrackingCode` (string)
    Reference assigned by the carrier to the shipment
    Example: "PARC0001"

  - `shippingLabels.carrierTrackingUrl` (string)
    URL for shipment tracking
    Example: "https://carrier.com/tracking/S4848554544545"

  - `shippingLabels.isLabelFree` (boolean)
    Flag to indicate the shipment is label free
    Example: true

  - `shippingLabels.labelFreeCode` (object)
    Code to be used for the delivery of the package to the carrier in the case of label-free shipments

  - `shippingLabels.labelFreeCode.format` (string)
    Format of the label or free-label code
    Enum: "PDF", "ZPL", "PNG"

  - `shippingLabels.labelFreeCode.base64` (string)
    Label-free code in base64
    Example: "AFJJJKJLDHKFJDLLKJKL..."

  - `shippingLabels.labelFreeCode.url` (string)
    URL for getting the label-free code
    Example: "https://if.com/image.png"

  - `shippingLabels.base64` (string)
    Shipping label in base64
    Example: "R0lGODlhLAGCAPcAAAAA..."

  - `shippingLabels.url` (string)
    URL for getting the shipping label
    Example: "https://if.com/shippping_label.pdf"

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.code` (string)
    Error code
    Example: "VA001"

  - `errors.message` (string)
    Error message
    Example: "The origin address is not valid"


## Response 401 fields

## Response 404 fields

## Response 405 fields

## Response 500 fields