Skip to main content
GET
/
tracking
/
{tracking_number}
Retrieve tracking information of a parcel
curl --request GET \
  --url https://panel.sendcloud.sc/api/v2/tracking/{tracking_number} \
  --header 'Authorization: Basic <encoded-value>'
{
  "parcel_id": "629",
  "carrier_code": "postnl",
  "created_at": "2022-01-25 14:42:03.277703+00:00",
  "carrier_tracking_url": "https://tracking.sendcloud.sc/forward?carrier=postnl&code=3SYZXG132912330&destination=NL&lang=en-us&source=NL&type=parcel&verification=5611+EM&servicepoint_verification=&created_at=2022-01-25",
  "sendcloud_tracking_url": "https://my-bakery.shipping-portal.com/tracking/?country=nl&tracking_number=3SYZXG132959174&postal_code=5611+EM",
  "is_return": false,
  "is_to_service_point": false,
  "is_mail_box": false,
  "expected_delivery_date": "2022-01-26",
  "statuses": [
    {
      "carrier_update_timestamp": "2022-01-25 14:43:13.615997+00:00",
      "parcel_status_history_id": "8",
      "parent_status": "shipment-on-route",
      "carrier_code": "postnl",
      "carrier_message": ""
    },
    {
      "carrier_update_timestamp": "2022-01-25 14:42:06.318296+00:00",
      "parcel_status_history_id": "7",
      "parent_status": "ready-to-send",
      "carrier_code": "",
      "carrier_message": "Ready to send"
    },
    {
      "carrier_update_timestamp": "2022-01-25 14:42:03.298949+00:00",
      "parcel_status_history_id": "6",
      "parent_status": "announcing",
      "carrier_code": "",
      "carrier_message": "Being announced"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Path Parameters

​
tracking_number
string
required

The tracking number that the user received

Response

OK

A definition of a detailed tracking blob.

​
parcel_id
string

Unique ID for the parcel

Example:

"629"

​
carrier_code
enum<string>

A carrier represented by a Sendcloud code

Available options:
amazon,
bol,
bpost,
brt,
budbee,
chronopost,
cirro,
colisprive,
colissimo,
correos,
correos_express,
ctt_express,
dbschenker,
delivengo,
dhl,
dhl_2_man_handling,
dhl_de,
dhl_ecommerce,
dhl_express,
dhl_parcel_gb,
dhl_parcel_iberia,
dp,
dpd,
dpd_at,
dpd_fr,
dpd_gb,
dpd_local,
evri_international,
fadello,
fairsenden,
fedex,
fedexcrossborder,
fietskoeriers,
geodis,
glovo,
gls_de,
gls_es,
gls_eu,
gls_it,
gls_nl,
hermes_at,
hermes_c2c_gb,
hermes_de,
hermes_gb,
hived,
homerr,
hurby,
inpost_es,
inpost_gb,
inpost_it,
inpost_pl,
lettresuivie,
mhi,
mondial_relay,
mrw,
nacex,
paack,
parcelforce,
plx,
postat,
poste_italiane,
poste_it_delivery,
postnl,
postnl_fulfilment,
postnl_large,
postnord,
rjp,
rjpv2,
royal_mail,
sandd,
sendcloud,
seur,
skymail,
spring,
storeshippers,
tipsa,
tnt_it,
transforce,
trunkrs,
ups,
van_straaten,
viatim,
yodel
Example:

"postnl"

​
created_at
string

Timestamp (ISO format) that indicates when the parcel was first tracked by Sendcloud’s systems.

Example:

"2022-01-25 14:42:03.277703+00:00"

​
carrier_tracking_url
string

Link to the carrier’s Tracking page for this parcel

Example:

"https://tracking.sendcloud.sc/forward?carrier=postnl&code=3SYZXG132912330&destination=NL&lang=en-us&source=NL&type=parcel&verification=5611+EM&servicepoint_verification=&created_at=2022-01-25"

​
sendcloud_tracking_url
string

Link to Sendcloud’s Tracking page for this parcel. Returns a valid URL only if the tracking page for the brand associated with the parcel has been published.

Example:

"https://my-bakery.shipping-portal.com/tracking/?country=nl&tracking_number=3SYZXG132912330&postal_code=5611+EM"

​
is_return
boolean

Indicates whether this parcel is a return (incoming) shipment to the merchant.

Example:

false

​
is_to_service_point
boolean

Indicates whether this parcel is delivered to a service point (e.g. a supermarket, as opposed to a home address)

Example:

false

​
is_mail_box
boolean

Indicates whether this parcel will be delivered to a mail box

Example:

false

​
expected_delivery_date
string<date>

Day when the parcel will be delivered (estimate, no timestamp)

Example:

"2022-01-26"

​
statuses
Detailed Tracking Blob Status Object · object[]