Site Logo

🎉 ShipEngine is becoming ShipStation API 🎉

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our New ShipStation API page.

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.