Start Tracking Updates

POST /v1/tracking/start

This endpoint allows you to subscribe to tracking updates for a package. You specify the carrier_code and tracking_numberof the package, and we'll notify you whenever the shipping status changes.

Requirements

You'll need the carrier_code and tracking_numberof the package.
You can track labels created outside of ShipEngine as long as you have the carrier connected to your ShipEngine account. For example, you can track a DHL label through ShipEngine even if you didn't created it through ShipEngine, but you must have a DHL carrier connected to your ShipEngine account.
You need to set up webhooks first, so we know how to notify you of tracking updates.

Example Request

1
2
3
POST /v1/tracking/start?carrier_code=stamps_com&tracking_number=9361269903502070406152 HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__

If successful, ShipEngine will respond with an HTTP Status Code of 204 (No Content).

You can unsubscribe from updates at any time by stopping tracking updates. However, ShipEngine automatically unsubscribes from tracking updates once a package is delivered or when a delivery exception occurs. So, you don't need to explicitly unsubscribe in these cases.