Shipment Tracking

Tracking resource is an object representing information about the current status of the shipment in the logistics system. It can be utilized to get information about the creation, status change and status history of the shipment.

 

You can download a list of statuses occurring in tracking using [1.2.0] Statuses

Tracking is not available on the sandbox environment, no statuses are returned.

Tracking is returned for 45 days, counting from the date the shipment was created.


Structure

Tracking resource consists of the following attributes:

Attribute

Type

Description

Attribute

Type

Description

tracking_number

String

Shipment number.

type

String

Shipment type. Available types can be found here: Shipment sizes and services.

service

String

Shipment type (service). Available types can be found here Shipment sizes and services.

custom_attributes

Object

Additional attributes for locker shipments.

status

String

Current shipment status.

created_at

DateTime

Shipment creation date and time.

updated_at

DateTime

Last shipment update date and time.

tracking_details

Array

An array containing the history of shipment status changes in chronological descending order.

(Last status change appears first on the list)

expected_flow

Array

An array containing the predicted statuses through which the given shipment might change.

 

Additional attributes for parcel locker custom_attributes

Attribute

Type

Description

Attribute

Type

Description

target_machine_detail

Hash

Additional receiver locker parameters.

dropoff_machine_detail

Hash

Additional sender locker parameters.

size

String

Shipment size [A, B, C]

target_machine_id

String

Receiver locker name.

dropoff_machine_id 

String

Sender locker name.

 

An array of objects containing the history of status changes, sorted chronologically in descending order (the last status is the first in the list) tracking_details

Attribute

Type

Description

Attribute

Type

Description

status

String

Status name

origin_status

String 

Status symbol List of statuses that have origin_status assigned to them

agency 

String 

Agency name

datetime

String 

Time of change

 

Tracker resource example JSON format:

{ "tracking_number": "632085946340007012341234", "service": "inpost_locker_standard", "type": "inpost_locker_standard", "status": "delivered", "custom_attributes": { "size": "A", "target_machine_id": "KAT07A", "target_machine_detail": { "name": "KAT07A", "opening_hours": "24/7", "location_description": "Przy Instytucie Matematyki UŚ", "location": { "latitude": 50.26219, "longitude": 19.02902 }, "address": { "line1": "Bankowa 14", "line2": "40-007 Katowice" }, "type": [ "parcel_locker" ], "location247": true }, "end_of_week_collection": false }, "tracking_details": [ { "origin_status": "DOR", "status": "delivered", "agency": null, "location": null, "datetime": "2023-12-18T11:20:06.000+01:00" }, { "origin_status": "UWP", "status": "ready_to_pickup", "agency": null, "location": null, "datetime": "2023-12-18T10:14:01.000+01:00" }, { "origin_status": "PDD_2", "status": "out_for_delivery", "agency": null, "location": null, "datetime": "2023-12-18T08:37:45.000+01:00" }, { "origin_status": "PWO", "status": "adopted_at_source_branch", "agency": null, "location": null, "datetime": "2023-12-18T05:56:59.000+01:00" }, { "origin_status": "WZO", "status": "sent_from_source_branch", "agency": null, "location": null, "datetime": "2023-12-17T19:10:51.000+01:00" }, { "origin_status": "PWO", "status": "adopted_at_source_branch", "agency": null, "location": null, "datetime": "2023-12-17T17:39:59.000+01:00" }, { "origin_status": "PPN", "status": "confirmed", "agency": null, "location": null, "datetime": "2023-12-17T12:58:39.000+01:00" } ], "expected_flow": [], "created_at": "2023-12-17T12:58:39.539+01:00", "updated_at": "2023-12-18T11:20:07.005+01:00" }

 

Authentication

Resource access does not require authentication.

 

Shipment History

Retrieving information about shipment status changes:

GET /v1/tracking/:tracking_number

Example request:

curl -X GET https://api-shipx-pl.easypack24.net/v1/tracking/632085946340007012341234 -H 'Content-Type: application/json'

Response:

If the given tracking number is correct and the shipment has been found, the following information is returned:

Response example of a shipment that has not been found:

Response example for a tracking number for which the shipment type could not be determined:


 

Shipment service history

Mixed shipments services can be changed during the logistics processing.
Shipments service history can be retrieved using the following resource:

Request example:

Response: