Tracking Events

Tracking events available for subscription:

Event Code	Title	Event Description	Additional Data	Usage	Event Facing Type
CRE.1001	[Generic] Parcel Creation	Your parcel has been created.		Used generically for Parcel Creation	Customer
CRE.1002	[Generic] Ready for acceptance	Your parcel is ready for acceptance in the InPost Network.		Used generically for Customer Delivering	Customer
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
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
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
FMD.1004	Collected by courier in PUDO	Your parcel has been collected by the courier in the PUDO point			Customer
FMD.1005	Collected by courier in APM	Your parcel had been collected by the courier in the APM			Customer
FMD.9001	Parcel claimed	Your parcel is under a claim process		Used generically when a parcel was claimed	Operational
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
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
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
MMD.1004	[Generic] Line-Haul	Your parcel is on the move through our network.		Used generically when Parcels are within a line-haul	Customer
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
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
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
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
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
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
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
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
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
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
LMD.3007	Stored temporary in a service point	Your parcel had been stored temporarily on a service point			Customer
LMD.3008	Expired stored parcel	Your parcel stored in the box machine is expired			Customer
LMD.3009	Expired on temporary box machine	The pick up time expired on temporary box machine			Customer
LMD.3010	Expired on temporary box machine	Your parcel has not been collected on-time from the temporary box machine			Customer
LMD.3011	Expired on temporary collection point	Your parcel has not been collected on-time from the temporary collection point			Customer
LMD.3012	Redirect cancelled	The redirection of the parcel wasn’t possible			Customer
LMD.3013	Redirected to PUDO	Your parcel was redirected to a PUDO			Customer
LMD.3014	Redirected to APM	Your parcel was redirected to an APM			Customer
CC.001	Parcel at customs	Your parcel has been delivered to customs to proceed with the customs clearance process	Customs (origin or destination)		Operational
CC.002	Parcel customs cleared	Your parcel has being released by customs	Customs (origin or destination)		Operational
CC.003	Parcel held at customs	Your parcel has being held at customs for inspection	Customs (origin or destination)		Operational
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
LMD.9002	Expired	Your parcel has not been collected on-time.	lockerPoint, pudoPoint, mobileCourierPoint, logisticsCentre	Used when Parcels have expired at the delivery locker	Customer
LMD.9003	Oversized	Your parcel is oversized for the destination.		Used when Parcels are oversized for the target delivery location.	Operational
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
LMD.9005	[Generic] Undeliverable	Your parcel was undeliverable to the recipient.		Used generically when parcels are undeliverable.	Customer
LMD.9006	Undeliverable: Rejected by recipient	Your parcel was undeliverable to the recipient, as it was rejected.		Used when Parcels have been rejected by the receiver	Customer
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
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
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
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
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
LMD.9012	Stored temporary in a box machine	Your parcel had been stored temporarily on a box machine			Customer
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
EOL.1001	[Generic] Delivered	Your parcel has been delivered.	address, merchantAddress, logisticsCentre	Used generically when parcels have been delivered to the end customer	Customer
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
EOL.1003	Delivered at Safe Place	Your parcel had been delivered in a safe place	address	Used for home deliveries services	Customer
EOL.1004	Delivered at neighbour	Your parcel had been delivered to your neighbor	address	Used for home deliveries services	Customer
EOL.1005	Delivered with verified recipient	Your parcel was delivered with a ID check validation		Used for home deliveries services	Customer
EOL.9001	Missing	Your parcel has been marked as missing.		Used when Parcels have been definitively marked as missing	Operational
EOL.9002	Damaged	Your parcel has been marked as damaged.		Used when Parcels have been definitively marked as damaged	Operational
EOL.9003	Destroyed	Your parcel has been marked as destroyed.		Used when Parcels have been definitively marked as destroyed	Operational
EOL.9004	Cancelled	Your parcel has been marked as cancelled.		Used when Parcels have been definitively marked as cancelled	Operational
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
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
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
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
FUL.1003	[Generic] Dispatched	Your items have been dispatched from the fulfilment centre.		Used when Parcels are being dispatched from the fulfilment warehouse	Operational
INF.1001	COD payment received			Used when payment for COD was received	Operational
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
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

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"
    }
}