Returns tracking details for the given parcel, including when different events happened to it.
This endpoint doesn't contain precise personal location information, but can contain the city where events happen and some names (e.g. 'Parcel was signed for by JIMMY'). To get the public tracking URL that can be shared with the receiver, see the tracking_url key in the response from the create or view an order endpoints.
Note: The Sendle API does not currently expose webhooks, and this endpoint is the only way to retrieve tracking information. For updates, keep an eye on our Changelog!
We recommend getting new tracking information for each parcel once per hour.
You should limit your requests to this endpoint to 10 per second per unique IP. If you need a higher limit, reach out to our team.
Here's most of our tracking events and what they mean:
| Tracking Event | Description |
|---|---|
| Pickup Attempted | Driver attempted to pickup the parcel. |
| Pickup | Parcel successfully picked up. |
| Drop Off | Parcel has not yet been dropped off. |
| Dropped Off | Parcel left at a drop-off location. |
| Info | Information about the parcel. This can come from us or the delivery partner. |
| In Transit | Parcel in transit between hub locations. |
| Out for Delivery | Driver has the parcel and is taking it to be delivered. |
| Delivery Attempted | Parcel delivery attempted, but unsuccessful. |
| Delivered | Parcel successfully delivered. |
| Local Delivery | Delivery is being handled by a local partner (e.g. a local postal service or similar). |
| Card Left | Parcel delivery attempted and a card has been left for the receiver to arrange collection or re-delivery. |
| Left with Agent | Parcel has been left with a parcel connect location, POPStation, or similar for collection. |
| Damaged | Parcel has been marked as damaged. |
| Unable to Deliver | Parcel could not be delivered. |
| Expired | The label for this parcel has expired. |
If you receive an event type not on this list, look at the description of the event for more information.
Indicates that an unhandled error has occured with the Sendle API. We may have more information on the Sendle Status page. Contact [email protected] if the problem persists.