Tracking parcels
Sendcloud automatically tracks the latest status update for every parcel created in your account.
tracking_number of your parcel so you can lookup its delivery status. A unique tracking number is attached to every parcel as soon as you Create a parcel.
Example
To track a parcel, send a
GET
request to the Track a specific parcel endpoint with the unique parcel tracking_number. The example below demonstrates how a request and response might look.
Here’s a sample request:
Example request
1curl --location -g --request GET https://panel.sendcloud.sc/api/v2/tracking/JVGL06097547000198007881
Example response
The response back will include information about the parcel, the carrier and the expected delivery date. If you’ve created your own branded tracking page in your Sendcloud account, the link to it is displayed in the sendcloud_tracking_url field.
Tracking history is nested under the statuses object, and is listed in chronological order, starting from the moment the label was created up until the point of delivery. Tracking status messages are mapped from the carrier to the parent_status field. You can find a list of possible values and their definitions below.
1{
2 "parcel_id": "1",
3 "carrier_code": "dhl",
4 "created_at": "2022-06-16 15:04:42.663125+00:00",
5 "carrier_tracking_url": "https://tracking.eu-central-1-0.sendcloud.sc/forward?carrier=dhl&code=JVGL06097547000198007881&destination=NL&lang=en-us&source=NL&type=parcel&verification=5642+CV&servicepoint_verification=&created_at=2022-06-16",
6 "sendcloud_tracking_url": "https://sendcloudfr.shipping-portal.com/tracking/?country=nl&tracking_number=jvgl06097547000198007881&postal_code=5642+cv",
7 "is_return": false,
8 "is_to_service_point": false,
9 "is_mail_box": false,
10 "expected_delivery_date": "2022-06-17",
11 "statuses":
12 [
13 {
14 "carrier_update_timestamp": "2022-06-16 15:04:42.662024+00:00",
15 "parcel_status_history_id": "1295844071",
16 "parent_status": "no-label",
17 "carrier_code": "",
18 "carrier_message": "No label"
19 },
20 {
21 "carrier_update_timestamp": "2022-06-16 15:04:42.689445+00:00",
22 "parcel_status_history_id": "1295844072",
23 "parent_status": "announcing",
24 "carrier_code": "",
25 "carrier_message": "Being announced"
26 },
27 {
28 "carrier_update_timestamp": "2022-06-16 15:04:43.748505+00:00",
29 "parcel_status_history_id": "1295844092",
30 "parent_status": "ready-to-send",
31 "carrier_code": "",
32 "carrier_message": "Ready to send"
33 }
34 ]
35}
