Tracking parcels

Sendcloud automatically tracks the latest status update for every parcel created in your account.

Requirements: You’ll need to know the 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 --header 'Authorization: Basic <based-64-encoded-token>'

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}
Go to top