Contents
Get tracking events
Get the parcel's consolidated tracking events.
The response contains at most 100 events, ordered from newest to oldest.
Endpoint
[GET] /v4/tracking/parcels/{client_ref}
Attributes
| Key | Description | Datatype | Constraints |
| id | Unique event identifier | String | |
| client_ref | Parcel client reference | String | |
| waybill_carrier_ref | Carrier reference of the parcel's waybill | String | |
| tracking_event | Normalized tracking event code | String | One of the values listed below |
| additional_info | Additional event metadata | Object | |
| additional_info.description | Human-readable description of the event | String | |
| timestamp | Timestamp of occurrence | String | Format: YYYY-MM-DD HH:MM:SS |
| time_zone | Time zone offset of the event timestamp | String | Format: GMT+00:00 |
| ehub_location | EHub location associated with the event | String |
Tracking event values
| Value | Description |
| noa_received | Notification that the waybill is ready to be picked up. |
| waybill_arrived_at_ehub | Indicates that a waybill has arrived at the warehouse. |
| customs_cleared | The parcel has been cleared by the local customs authority. |
| customs_inspection | The parcel has been selected for inspection by the local customs authority. |
| customs_seized | The parcel has been seized by the local customs authority. |
| ehub_handover | The parcel is ready to be dispatched. |
| picked_up | The parcel has been picked up by a last mile courier. |
| delivered | The parcel has been delivered to the final delivery destination. |
Example
Response
[
{
"id": "evt_berD4wEdEdc33KYWzhjqAYJa",
"client_ref": "ORDER-10001",
"waybill_carrier_ref": "WB240001234",
"tracking_event": "delivered",
"additional_info": {
"description": "The parcel has been delivered to the final delivery destination."
},
"timestamp": "2026-04-16 15:24:10",
"time_zone": "GMT+02:00",
"ehub_location": "LGG"
},
{
"id": "evt_AjQVKxOrW6s33aMkBvwgddlY",
"client_ref": "ORDER-10001",
"waybill_carrier_ref": "WB240001234",
"tracking_event": "picked_up",
"additional_info": {
"description": "The parcel has been picked up by a last mile courier."
},
"timestamp": "2026-04-15 06:40:21",
"time_zone": "GMT+02:00",
"ehub_location": "LGG"
},
{
"id": "evt_3V5pOy8UzahzzpK3xEJQsDqj",
"client_ref": "ORDER-10001",
"waybill_carrier_ref": "WB240001234",
"tracking_event": "customs_cleared",
"additional_info": {
"description": "The parcel has been cleared by the local customs authority."
},
"timestamp": "2026-04-14 11:08:53",
"time_zone": "GMT+02:00",
"ehub_location": "LGG"
}
]