Track Using a Label ID

If you generate your labels through ShipEngine, then you can easily subscribe to real-time tracking events using the label ID.

You can also track packages for which you did not use ShipEngine to generate the label, as long as you have the tracking number. See Track a Package for details.



  • You will need a label_id from another Label Request, if you don't have one you can learn how to Create a Label.


GET /v1/labels/:label_id/track

This endpoint allows you to track a specific label that was generated with ShipEngine. You just need the label_id, which you got back when you created the label.

Example Request

curl -iX GET \
-H 'Content-Type: application/json' \
GET /v1/labels/se-324658/track HTTP/1.1
cache-control: no-cache

Example Response

  "tracking_number": "1Z932R800390810600",
  "status_code": "DE",
  "status_description": "Delivered",
  "carrier_status_code": "D",
  "carrier_status_description": "DELIVERED",
  "shipped_date": "2019-07-27T11:59:03.289ZYesterday$",
  "estimated_delivery_date": "2019-07-27T11:59:03.289Z",
  "actual_delivery_date": "2019-07-27T11:59:03.289Z",
  "exception_description": null,
  "events": [
    "occurred_at": "2019-07-27T11:59:03.289Z",
    "description": "Delivered, In/At Mailbox",
    "city_locality": "AUSTIN",
    "state_province": "TX",
    "postal_code": "78756",
    "country_code": "",
    "company_name": "",
    "signer": ""

Tracking Status Codes

status_code status_description tracking_status
AC Accepted N/A
IT In Transit in_transit
DE Delivered delivered
EX Exception error
UN Unknown unknown
AT Delivery Attempt N/A