Tracking Events

Event Versioning

Event versioning is a structured mechanism implemented in the track API & webhooks to support forward evolution while preserving backward compatibility. Each event includes a version identifier that defines the schema and logic applied when the event was sent.

To ensure long-term reliability, we provide full support for all previous event versions. Version V1 will be supported indefinitely, while all subsequent versions will be supported for up to 24 months from their introduction, allowing existing integrations to continue functioning without requiring modifications.

What merchants can expect ?

Reliable Integrations: Events behave consistently across environments, regardless of backend updates.
Non-Disruptive Evolution: New versions can be introduced without impacting existing consumers, allowing for controlled adoption.
Safe and Flexible Upgrades: New versions can be adopted when appropriate, minimizing the risk of unexpected changes.
Enhanced Observability: Version identifiers improve monitoring, debugging, and supportability over time.

Tracking events available for subscription:

Event Code	Title	Event Description	Additional Data	Usage	Event Facing Type	Version	Release date	Market
CRE.1001	[Generic] Parcel Creation	Your parcel has been created.		Used generically for Parcel Creation	Customer	V1	21 JAN 2025	All
CRE.1002	[Generic] Ready for acceptance	Your parcel is ready for acceptance in the InPost Network.		Used generically for Customer Delivering	Customer	V1	21 JAN 2025	not in use
FMD.1001	[Generic] Ready for courier collection	Your parcel is starting its journey and will be collected by our couriers.	lockerPoint, pudoPoint, address, merchantAddress, mobileCourierPoint	Used generically when Parcels are ready to collection	Customer	V1	21 JAN 2025	All
FMD.1002	[Generic] Collected by courier	Your parcel has started its journey and is on its way to one of our logistics centres.	lockerPoint, pudoPoint, address, merchantAddress, mobileCourierPoint	Used generically when Parcels are collected by a courier	Customer	V1	21 JAN 2025	All
FMD.1003	[Generic] In-transit (first-mile)	Your parcel is on the move through our network.		Used generically when Parcels are in-transit for the first mile	Customer	V1	21 JAN 2025	All
FMD.1004	Collected by courier in PUDO	Your parcel has been collected by the courier in the PUDO point			Customer	V1	21 JAN 2025	All
FMD.1005	Collected by courier in APM	Your parcel had been collected by the courier in the APM			Customer	V1	21 JAN 2025	All
FMD.9001	Parcel claimed	Your parcel is under a claim process		Used generically when a parcel was claimed	Operational	V1	21 JAN 2025	All
FMD.9002	Parcel oversized	Your parcel has been marked as oversized for our network.		Used for parcels that are measured oversized in our depots	Operational	V1	9 MAY 2025	UK
MMD.1001	[Generic] Adopted at Logistics Centre	Your parcel has been received at one of our logistics centres.	logisticsCentre	Used generically when Parcels are adopted at a logistics centre	Customer	V1	21 JAN 2025	All
MMD.1002	[Generic] Processed at Logistics Centre	Your parcel has been processed at one of our logistics centres.	logisticsCentre	Used generically when Parcels are processed at a logistics centre	Operational	V1	21 JAN 2025	All
MMD.1003	[Generic] Dispatched from Logistics Centre	Your parcel has been dispatched from one of our logistics centres.	logisticsCentre	Used generically when Parcels are dispatched from a logistics centre	Customer	V1	21 JAN 2025	All
MMD.1004	[Generic] Line-Haul	Your parcel is on the move through our network.		Used generically when Parcels are within a line-haul	Customer	V1	21 JAN 2025	All
MMD.3001	Containerised at Logistics Centre	Your parcel has been containerised at one of our logistics centres.	logisticsCentre		Operational	V1	9 MAY 2025	UK
MMD.9001	Quarantine at Logistics Centre	Your parcel has been quarantined at one of our logistics centres.	logisticsCentre	Used when parcels are held at logistics centres for further investigation or fault resolution	Operational	V1	7 MAY 2025	UK
LMD.1001	[Generic] In-transit (last-mile)	Your parcel is on its way to its final destination.		Used generically when Parcels are in-transit for the last mile	Customer	V1	21 JAN 2025	All
LMD.1002	[Generic] Arrived at destination	Your parcel has arrived at its final destination.	lockerPoint, pudoPoint, address, merchantAddress, mobileCourierPoint, logisticsCentre	Used generically when Parcels have arrived at the delivery destination	Customer	V1	21 JAN 2025	All
LMD.1003	[Generic] Ready to collect	Your parcel is ready for collection from the destination.	lockerPoint, pudoPoint, mobileCourierPoint, logisticsCentre	Used generically when Parcels are ready to collect	Customer	V1	21 JAN 2025	All
LMD.1004	Ready to collect PUDO	Your parcel is ready for collection at the designated PUDO		Used for parcels dropped at the PUDO waiting for collection	Customer	V1	21 JAN 2025	All
LMD.1005	Ready to collect APM	Your parcel is ready for collection at the locker		Used for parcels delivered at the APM and waiting for collection	Customer	V1	21 JAN 2025	All
LMD.1006	Ready to collect at collection point	Your parcel is ready for collection at the collection point	lockerpoint,pudopoint		Customer	V1	8 APR 2025	All
LMD.3001	[Generic] Alternative collection point assigned	Your parcel has been redirected to an alternative collection location.	lockerpoint,pudopoint	Used generically when Parcels have been reassigned a new collection location.	Customer	V1	8 APR 2025	All
LMD.3002	Alternative temporary collection point assigned	Your parcel has temporarily been assigned a different collection point.	lockerPoint, pudoPoint, mobileCourierPoint	Used when Parcels are to be temporarily reassigned to a different collection point.	Customer	V1	21 JAN 2025	PL
LMD.3003	Alternative collection point assigned	Your parcel has been assigned a different collection point.	lockerPoint, pudoPoint, mobileCourierPoint	Used when Parcels are reassigned to a different collection point.	Customer	V1	21 JAN 2025	All
LMD.3004	Branch collection assigned	Your parcel has been assigned to be collected from a nearby branch.	logisticsCentre	Used when Parcels are assigned to be collected from a nearby branch.	Customer	V1	21 JAN 2025	All
LMD.3005	Original collection point reassigned	Your parcel has been routed back to its original collection point.	lockerPoint, pudoPoint, mobileCourierPoint	Used when Parcels which have been reassigned a new collection point are rerouted back the original collection point.	Customer	V1	21 JAN 2025	All
LMD.3006	Delivery readdressed	Your parcel has been readdressed to a new delivery location	lockerPoint, pudoPoint, mobileCourierPoint, merchantAddress, address	Used when Parcels are requested to be delivered to a new delivery location	Customer	V1	21 JAN 2025	All
LMD.3007	Stored temporary in a service point	Your parcel had been stored temporarily on a service point			Customer	V1	21 JAN 2025	PL
LMD.3008	Expired stored parcel	Your parcel stored in the box machine is expired			Customer	V1	21 JAN 2025	All
LMD.3009	Expired on temporary box machine	The pick up time expired on temporary box machine			Customer	V1	21 JAN 2025	PL
LMD.3010	Expired on temporary box machine	Your parcel has not been collected on-time from the temporary box machine			Customer	V1	21 JAN 2025	PL
LMD.3011	Expired on temporary collection point	Your parcel has not been collected on-time from the temporary collection point			Customer	V1	21 JAN 2025	PL
LMD.3012	Redirect cancelled	The redirection of the parcel wasn’t possible			Customer	V1	21 JAN 2025	All
LMD.3013	Redirected to PUDO	Your parcel was redirected to a PUDO	pudopoint		Customer	V1	21 JAN 2025	All
LMD.3014	Redirected to APM	Your parcel was redirected to an APM	lockerpoint		Customer	V1	21 JAN 2025	All
LMD.3015	Permanently Redirected to PUDO by InPost	Your parcel was permanently redirected to a PUDO	pudopoint	For parcels that are redirected by the system due to capacity constraints to the nearby Pudo point	Customer	V1	7 MAY 2025	UK
LMD.3016	Permanently Redirected to APM by InPost	Your parcel was permanently redirected to an APM	lockerpoint	For parcels that are redirected by the system due to capacity constraints to the nearby APM	Customer	V1	7 MAY 2025	UK
CC.001	Parcel at customs	Your parcel has been delivered to customs to proceed with the customs clearance process	Customs (origin or destination)		Operational	V1	21 JAN 2025	All
CC.002	Parcel customs cleared	Your parcel has being released by customs	Customs (origin or destination)		Operational	V1	21 JAN 2025	All
CC.003	Parcel held at customs	Your parcel has being held at customs for inspection	Customs (origin or destination)		Operational	V1	21 JAN 2025	All
LMD.9001	Reminder to collect	Your parcel must be collected soon.	lockerPoint, pudoPoint, mobileCourierPoint, logisticsCentre	Used generically when Parcels are nearing expiry at the delivery locker	Customer	V1	21 JAN 2025	All
LMD.9002	Expired	Your parcel has not been collected on-time.	lockerPoint, pudoPoint, mobileCourierPoint, logisticsCentre	Used when Parcels have expired at the delivery point	Customer	V1	21 JAN 2025	All
LMD.9003	Oversized	Your parcel is oversized for the destination.		Used when Parcels are oversized for the target delivery location.	Operational	V1	21 JAN 2025	All
LMD.9004	[Generic] Attempted delivery	We attempted to deliver your parcel but were unable to do this successfully. We will reattempt to deliver your parcel.	lockerPoint, pudoPoint, mobileCourierPoint, address, merchantAddress	Used generically when delivery at a location has been attempted and unsuccessful, but delivery will be reattempted.	Customer	V1	21 JAN 2025	PL
LMD.9005	[Generic] Undeliverable	Your parcel was undeliverable to the recipient.		Used generically when parcels are undeliverable.	Customer	V1	21 JAN 2025	All
LMD.9006	Undeliverable: Rejected by recipient	Your parcel was undeliverable to the recipient, as it was rejected.		Used when Parcels were undeliverable due to was rejected by the recipient	Customer	V1	21 JAN 2025	All
LMD.9007	Undeliverable: Incorrect delivery details	Your parcel was undeliverable to the recipient, as it had incorrect delivery details.		Used when Parcels were undeliverable due to incorrect delivery data.	Customer	V1	21 JAN 2025	All
LMD.9008	Undeliverable: Receiver unknown	Your parcel was undeliverable to the recipient, as the recipient could not be identified.		Used when Parcels were undeliverable due to the recipient not being identifiable or known from the provided details.	Customer	V1	21 JAN 2025	All
LMD.9009	Undeliverable: COD conditions not met	Your parcel was undeliverable to the recipient, as the recipient did not meet the requirements for cash on delivery.		Used when Parcels have failed COD conditions and cannot be delivered.	Customer	V1	21 JAN 2025	All
LMD.9010	Undeliverable: No mailbox	Your parcel was undeliverable due to no mailbox at the delivery location.		Used when Parcels were undeliverable due to lack of a mailbox or safe place.	Customer	V1	21 JAN 2025	All
LMD.9011	Undeliverable: No access to location	Your parcel was undeliverable due to lack of access to the location.		Used when Parcels were undeliverable due to a lack of access to the delivery location.	Customer	V1	21 JAN 2025	All
LMD.9012	Stored temporary in a box machine	Your parcel had been stored temporarily on a box machine			Customer	V1	21 JAN 2025	PL
LMD.9013	Parcel ready to collect at customer service point	Your parcel dropped by the courier into a customer service point		Used for parcels that had delivery attempt at home and courier has dropped the parcel into a customer service point to be collected by the customer	Customer	V1	21 JAN 2025	All
LMD.9014	Uncollected Parcel- Return to sender initiated	The timing for collecting the parcel has expired the return to sender will be initiated		Used for parcels that had expired in the collection point and were already pick up by the courier	Customer	V1	8 APR 2025	PL
LMD.9015	Delivery Attempt-Incorrect Delivery Details	Your parcel wasn't able to be delivered due to incorrect address details	Location address		Customer	V1	8 APR 2025	All
LMD.9016	Delivery Attempt-No access location	Your parcel wasn't able to be delivered due to issues accessing the location	Location address		Customer	V1	8 APR 2025	All
LMD.9017	Delivery Attempt- No answer	Your parcel wasn't able to be delivered due to no answer	Location address		Customer	V1	8 APR 2025	All
LMD.9018	Delivery Attempt Failed	Your parcel wasn't able to be delivered on the final attempt	Location address		Customer	V1	8 APR 2025	UK
LMD.9019	Parcel not collected	Your parcel wasn't collect at the collection point and will be returning to sender			Customer	V1	8 APR 2025	UK
LMD.9020	APM not available- access issue	Your parcels wasn't able to be dropped in the APM due to access issue			Operational	V1	8 APR 2025	UK
LMD.9021	Not suitable compartment on APM	Your parcel doesn't have a suitable compartment on APM			Operational	V1	8 APR 2025	UK
LMD.9022	APM Full	Your parcel wasn't able to be dropped as the APM was full			Operational	V1	8 APR 2025	UK
LMD.9023	APM not available - login access issue	Your parcel wasn't able to be dropped into the APM due to access issues			Operational	V1	8 APR 2025	UK
LMD.9024	PUDO Closed	Your parcel wasn't able to be dropped as the PUDO was closed.			Operational	V1	8 APR 2025	UK
LMD.9025	Access Issue on Delivery	Your parcel wasn't able to be dropped as there has been access issue to the target delivery point			Operational	V1	8 APR 2025	UK
EOL.1001	[Generic] Delivered	Your parcel has been delivered.	address, merchantAddress, logisticsCentre	Used generically when parcels have been delivered to the end customer	Customer	V1	21 JAN 2025	All
EOL.1002	Parcel collected	Your parcel has been collected	lockerPoint, pudoPoint	Used generically for parcels that were collected by customers in the collect points	Customer	V1	21 JAN 2025	All
EOL.1003	Delivered at Safe Place	Your parcel had been delivered in a safe place	address	Used for home deliveries services	Customer	V1	21 JAN 2025	All
EOL.1004	Delivered at neighbour	Your parcel had been delivered to your neighbor	address	Used for home deliveries services	Customer	V1	21 JAN 2025	All
EOL.1005	Delivered with verified recipient	Your parcel was delivered with a ID check validation		Used for home deliveries services	Customer	V1	21 JAN 2025	All
EOL.9001	Missing	Your parcel has been marked as missing.		Used when Parcels have been definitively marked as missing	Operational	V1	21 JAN 2025	All
EOL.9002	Damaged	Your parcel has been marked as damaged.		Used when Parcels have been definitively marked as damaged	Operational	V1	21 JAN 2025	All
EOL.9003	Destroyed	Your parcel has been marked as destroyed.		Used when Parcels have been definitively marked as destroyed and will not be delivered.	Operational	V1	21 JAN 2025	All
EOL.9004	Cancelled	Your parcel has been marked as cancelled.		Used when Parcels have been definitively marked as cancelled	Operational	V1	21 JAN 2025	All
RTS.1001	[Generic] Returning to Sender	Your parcel is starting its journey back to the sender.		Used when Parcels are starting their journey back to the sender	Customer	V1	21 JAN 2025	All
RTS.1002	[Generic] Returned to Sender	Your parcel has been received by the sender.		Used when Parcels have been delivered to the end customer	Customer	V1	21 JAN 2025	All
FUL.1001	[Generic] Picked	Your items have been picked and are being prepared for dispatch.		Used when Parcels are being picked within the fulfilment warehouse	Operational	V1	21 JAN 2025	All
FUL.1002	[Generic] Packed	Your items have been packed and are being prepared for dispatch.		Used when Parcels are being packed within the fulfilment warehouse	Operational	V1	21 JAN 2025	All
FUL.1003	[Generic] Dispatched	Your items have been dispatched from the fulfilment centre.		Used when Parcels are being dispatched from the fulfilment warehouse	Operational	V1	21 JAN 2025	All
INF.1001	COD payment received			Used when payment for COD was received	Operational	V1	21 JAN 2025	All
INF.9001	Delay in Delivery	We are informing you that you may experience delays with our service in delivering your parcel.		Used when a delay in delivery must be communicated for the parcel.	Operational	V1	21 JAN 2025	All
HAN.1001	[Generic] Handover	Your parcel is being handed over to another party.	logisticsCentre	Used generically when a parcel is handed over from one party to another.	Operational	V1	21 JAN 2025	All

Release Notes

See a change log here

V1 | 21 JAN 2025
V1 | 8 APR 2025
V1 | 7 MAY 2025
V1 | 9 MAY 2025

Event Object (root object)

Field	Nullable?	Type	Description
customerReference	Yes	String	Reference/ID passed by the merchant when creating the shipment
trackingNumber	no	String	Tracking number generated by InPost
eventId	no	String	Unique id of the event (same as x-inpost-event-id header)
eventCode	no	String	Code of the event (refer to the event catalogue documentation for the possible values)
timestamp	no	Datetime	Date and time when the event occurred, in the local time zone (ISO 8601)
location	Yes	Location object	Location of the event
delivery	Yes	Delivery object	Information of delivery, in case it’s a delivery event.
shipment	Yes	Shipment object	Information about the
returnToSender	Yes	RTS object	The parcel's data for Return To Sender
newDestination	Yes	Location object	Information about the new destination for redirected parcel

Location Object

Field	Nullable?	Type	Description
id	Yes	String	ID of the location
type	no	String	One of: LOCKER_POINT, LOGISTIC_CENTER, PUDO_POINT, ADDRESS, MPOK_POINT
name	Yes	String	Name/description of PUDO/APM
address	Yes	String	Street, door number
postalCode	Yes	String	Postal code
city	Yes	String	City name
country	Yes	String	Country code (ISO2)
description	Yes	String	Description of the location

Delivery Object

Field	Nullable?	Type	Description
recipientName	Yes	String	Name of person who received the parcel
deliveryNotes	Yes	String	Notes provided by the courier upon delivery

Shipment Object

Field	Nullable?	Type	Description
type	Yes	String	One of: OUTBOUND, RETURN

RTS Object

Field	Nullable?	Type	Description
trackingNumber	Yes	String	Tracking number or returned parcel

Example

{
  "customerReference": "XXXXXX",
  "trackingNumber": "XXXXXX",
  "eventId": "XYZ123",
  "eventCode": "ABC987",
  "timestamp": "2024-04-26T14:00:03.165Z",
  "location": {
    "id": "PL_ASDF",
    "type": "PUDO_POINT",
    "name": "ASDF",
    "address": "street name, door num, etc.",
    "postalCode": "999999-999",
    "city": "Tracking Town",
    "country": "PL",
    "description": "on the left side of Petrol Station XYZ"
  },
  "delivery": {
    "recipientName": "John Doe",
    "deliveryNotes": "Delivered in hand"
  },
  "shipment": {
    "type": "OUTBOUND"
  },
  "returnToSender": {
    "trackingNumber": "XXXXXXXX"
  },
  "newDestination": {
    "id": "PL_XYZ",
    "type": "LOCKER_POINT",
    "name": "XYZ",
    "address": "street building",
    "postalCode": "999999-999",
    "city": "Town",
    "country": "PL",
    "description": "behind the shop building"
  }
}