{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/tracking/track-by-label-id","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/tracking/track-by-label-id","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/tracking/track-by-label-id","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Track Using a Label ID","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"track-using-a-label-id","__idx":0},"children":["Track Using a Label ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With ShipStation API, you can retrieve real-time tracking events for ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["any"]}," package, even if you created the label outside of ShipStation API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two methods you can use for tracking shipments:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the label endpoint to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/tracking/track-by-label-id"},"children":["track by Label ID"]},". We recommend this method for tracking labels created via ShipStation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the tracking endpoint. This option requires you to specify the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_code"]}," and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tracking_number"]}," of the package. If you don’t know a carrier’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_code"]},", you can find it by ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carriers"},"children":["listing carriers"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page provides details about tracking using the label ID. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/tracking/tracking"},"children":["Track a Package page"]}," for details about using the tracking endpoint method."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You will need the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_id"]}," from a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["Create Label request"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":2},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /v1/labels/:label_id/track"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint allows you to track a specific label that was generated with ShipStation API."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v1/labels/se-324658/track HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nCache-Control: no-cache\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"tracking_number\": \"1Z932R800390810600\",\n  \"status_code\": \"DE\",\n  \"status_description\": \"Delivered\",\n  \"carrier_status_code\": \"D\",\n  \"carrier_status_description\": \"DELIVERED\",\n  \"shipped_date\": \"2019-07-27T11:59:03.289Z\",\n  \"estimated_delivery_date\": \"2019-07-27T11:59:03.289Z\",\n  \"actual_delivery_date\": \"2019-07-27T11:59:03.289Z\",\n  \"exception_description\": null,\n  \"events\": [\n    {\n      \"occurred_at\": \"2019-09-13T12:32:00Z\",\n      \"carrier_occurred_at\": \"2019-09-13T05:32:00\",\n      \"description\": \"Arrived at USPS Facility\",\n      \"city_locality\": \"OCEANSIDE\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"92056\",\n      \"country_code\": \"\",\n      \"company_name\": \"\",\n      \"signer\": \"\",\n      \"event_code\": \"U1\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"about-the-tracking-response","__idx":3},"children":["About the Tracking Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Event Timestamps:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_occurred_at"]}," is the timestamp of the event received from the carrier. It is assumed to be the local time of where the event occurred. This event property is not yet fully supported across all carriers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occurred_at"]}," is our best effort at converting the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_occurred_at"]}," field to UTC, based on the time of the event's occurrence."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tracking-status-codes","__idx":4},"children":["Tracking Status Codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's how the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status_description"]}," fields correspond to each other and how they correspond to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tracking_status"]}," field of a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["label"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"status_code"},"children":["status_code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"status_description"},"children":["status_description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"tracking_status"},"children":["tracking_status"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AC"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepted"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["In Transit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_transit"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivered"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exception"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unknown"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unknown"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery Attempt"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not Yet In System"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_transit"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SP"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivered To The Collection Location"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered_to_service_point"]}]}]}]}]}]}]},"headings":[{"value":"Track Using a Label ID","id":"track-using-a-label-id","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":2},{"value":"About the Tracking Response","id":"about-the-tracking-response","depth":2},{"value":"Tracking Status Codes","id":"tracking-status-codes","depth":3}],"frontmatter":{"seo":{"title":"Track Using a Label ID"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/tracking/track-by-label-id","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}