We're announcing 🧑‍🚀 inter-galactic shipping ✨ for 3025!
Cosmo Cargo Inc.
Labels & Stamps API

Labels (3.0.0)

Endpoint

Endpoints for managing shipping labels. Labels are printable documents that contain:

  • Shipping address information
  • Tracking barcodes
  • Carrier-specific routing data
  • Package details

Create a shipping label

POST
https://eedefc50718545d6b3a6cd7ea38faf06_oas.api.mockbin.io
/labels

Creates a new shipping label for a shipment.

The generated label will be available for download through the returned URL for 24 hours.

Create a shipping label › Request Body

  • shipmentIdstring · uuid · required
  • formatstring · enum · required
    Enum values:
    PDF
    PNG
    ZPL
  • idstring · uuid · readOnly
  • sizestring · enum
    Enum values:
    4x6
    6x4
    8.5x11
  • urlstring · uri · readOnly
  • createdAtstring · date-time · readOnly
  • expiresAtstring · date-time · readOnly

Create a shipping label › Responses

Label created successfully

  • shipmentIdstring · uuid · required
  • formatstring · enum · required
    Enum values:
    PDF
    PNG
    ZPL
  • idstring · uuid · readOnly
  • sizestring · enum
    Enum values:
    4x6
    6x4
    8.5x11
  • urlstring · uri · readOnly
  • createdAtstring · date-time · readOnly
  • expiresAtstring · date-time · readOnly

Invalidate a shipping label

PUT
https://eedefc50718545d6b3a6cd7ea38faf06_oas.api.mockbin.io
/labels/{id}/invalidate

Invalidates a shipping label, making it no longer available for download.

Invalidate a shipping label › path Parameters

  • idstring · uuid · required

    The ID of the label to invalidate

Invalidate a shipping label › Responses

Label invalidated successfully

No data returned

Get tracking number

GET
https://eedefc50718545d6b3a6cd7ea38faf06_oas.api.mockbin.io
/labels/{id}/trackingnumber

Retrieves the tracking number associated with a shipping label.

Get tracking number › path Parameters

  • idstring · uuid · required

    The ID of the shipping label

Get tracking number › query Parameters

  • formatstring · enum

    The format of the response

    Enum values:
    basic
    detailed
    carrier-specific
    Default: basic
  • limitinteger · min: 1 · max: 100

    Maximum number of tracking events to return

    Default: 10
  • carrierstring · enum

    Filter tracking information by specific carrier

    Enum values:
    UPS
    USPS
    FedEx
    DHL
    Default: null
  • events_sincestring · date-time

    Only return tracking events after this timestamp

  • sortstring · enum

    Sort order for tracking events

    Enum values:
    newest_first
    oldest_first
    Default: newest_first

Get tracking number › Responses

Tracking number retrieved successfully

  • trackingNumberstring · required
    Example: 1Z999AA1234567890
  • carrierstring · required
    Example: UPS
  • trackingUrlstring · uri
    Example: https://www.ups.com/track?tracknum=1Z999AA1234567890

Get shipping label

GET
https://eedefc50718545d6b3a6cd7ea38faf06_oas.api.mockbin.io
/labels/{id}

Retrieves a shipping label by ID. The label can be requested in different formats.

Get shipping label › path Parameters

  • idstring · uuid · required

    The ID of the shipping label

Get shipping label › query Parameters

  • formatstring · enum

    The desired format of the label

    Enum values:
    PDF
    PNG
    ZPL
    JPEG
    TIFF
    SVG
    EPS
    BMP
    Default: PDF

Get shipping label › Responses

Label retrieved successfully

  • shipmentIdstring · uuid · required
  • formatstring · enum · required
    Enum values:
    PDF
    PNG
    ZPL
  • idstring · uuid · readOnly
  • sizestring · enum
    Enum values:
    4x6
    6x4
    8.5x11
  • urlstring · uri · readOnly
  • createdAtstring · date-time · readOnly
  • expiresAtstring · date-time · readOnly
Stamps