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"
    }
  ]
}
API v2 is entering maintenance mode. New users should start with API v3 to access our latest features and improved performance. Already using v2? Don’t worry, your current integration remains fully functional. Read more about maintenance mode, or check out the migration guide for API v3.

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[]