Skip to main content
Use the Retrieve tracking information for a parcel endpoint to retrieve a parcel’s current status and full tracking timeline using its tracking_number. This endpoint works for:

​
Calling the endpoint

To retrieve tracking information, send a GET request including the tracking number in the path:
Example request method and URL
GET https://panel.sendcloud.sc/api/v3/parcels/tracking/{tracking_number}

​
Response

If successful, the API returns:
  • HTTP 200 status code
  • A Parcel Tracking object containing:
    • Parcel lifecycle timestamps:
      • created_at — When the parcel tracking object was created in Sendcloud
      • announced_at — When the parcel was handed to the carrier
      • updated_at — Last time tracking information was updated
    • details: Additional context such as expected_delivery_date, integration_id, service point indicators, return flags
    • tracking_numbers: Carrier tracking identifiers associated with the parcel.
    • events: A chronological list of tracking events representing delivery milestones.
    • parent_status: carrier status messages standardized into a consistent Sendcloud status. This allows you to reliably interpret the parcel’s delivery state across different carriers.
Each event has a single source. However, the full timeline may contain both carrier events and internal Sendcloud events (see Parcel Tracking Key Concepts). The parcel’s current status can be derived from the most recent event in the timeline. If the tracking number is invalid or unknown, the API returns an error response instead of a parcel object.
See the API reference for the full response schema.

​
Status definitions

Sendcloud consolidates all the variations of status messages received by different carriers into a readable format. This corresponds with the parent_status field in the response.
StatusDescription
Address invalidThe provided address details are not correct.
AnnouncedThe shipping label has been announced at the carrier.
Announced: not collectedThe label is announced, but not yet collected by the driver.
Announcement failedThe label was not successfully announced at the carrier.
At customsThe parcel is passing through customs checks at the border.
At sorting centreThe parcel has arrived at the carrier sorting hub.
Awaiting customer pickupThe parcel has been delivered to a service point and is awaiting collection by the end customer.
Being announcedThe shipping label is awaiting annoucnement at the carrier.
Being sortedThe parcel is being sorted at the carrier sorting hub.
Cancellation requestCancellation has been requested for this parcel.
CancelledThe label was successfully cancelled at the carrier.
Cancelled upstreamThe label been cancelled upstream and is awaiting status Cancelled to be returned by the carrier.
DeliveredThe parcel has been delivered to the end customer.
Delivery address changedThe delivery address has been modified.
Delivery attempt failedThe end customer was not home to accept the delivery.
Delivery date changedThe delivery date for this parcel was changed.
Delivery delayedThe delivery will take place at a later time or date.
Delivery method changedThe method of delivery has been modified.
Driver en routeThe driver is on the way to deliver the parcel.
En route to sorting centerThe driver is on the way to the sorting centre.
Error collectingThe parcel could not be collected by the driver.
ExceptionThere has been an exception with the parcel.
No labelThere is no label attached to the parcel.
Not sortedThe parcel has not been sorted at the carrier sorting hub.
Parcel en routeThe parcel is on the way to be delivered.
Ready to sendThe label has been generated and announced, and the parcel can be picked up or taken to a service point to be delivered to the end customer.
Refused by recipientThe end customer refused to accept the delivery.
Returned to senderThe parcel is being returned to the sender.
Return payment failedPayment for the return label for this parcel has not been processed.
Shipment collected by customerThe end customer has collected the parcel from a service point.
Shipment picked up by driverThe driver has collected the parcel from the service point or requested pickup location.
SortedThe parcel has been sorted for delivery at the carrier sorting hub.
Submitting cancellation requestCancellation has been requested and is being processed.
Unable to deliverThe parcel could not be delivered to the intended address or service point.
Waiting for the return paymentThe carrier must receive payment for the return label before it is returned to sender.

​
Real-time event notifications

Instead of polling this endpoint for status changes, you can receive push notifications whenever parcel events occur. The Event Subscriptions API lets you configure webhooks or third-party integrations to be notified automatically.
The Event Subscriptions API is currently in BETA.