Supported tracking events

Learn about how tracking events help you and your customers understand the current status of an order.

The Tracking API supports the following types of tracking events:

• Shipping events
• Order events
• Return events

Shipping events

After a carrier has been selected for a shipment, you can start receiving shipping events from the carrier. These let you know the current shipping status of a parcel. This starts with a shipment being ready for collection by the carrier from the specified warehouse (shipping location).

Each carrier uses its own terminology to describe a shipping event. Some carriers use thousands of categories while other carriers use hundreds, but every carrier does things differently. This means that when reviewing tracking data from different carriers, it can become difficult to understand the delivery status of a shipment.

To help remove this confusion and to reduce complexity, the Tracking API maps all carrier events into 80 normalised terms that are easier to understand for your support agents and your shoppers.

You can use the shipping event codes below when adding events for a delivery leg.

#	Shipping event code	Status code	Event category	Description / Exception message
1	CARRIER_STATUS_NOT_MAPPED	IN_TRANSIT	SYSTEM	Unknown carrier event. Please check the carrier's website for updates.
2	CLOSED_BY_SYSTEM	NOT_DELIVERED	SYSTEM	Closed by System.
3	UNSPECIFIED_EXCEPTION	IN_TRANSIT	EXCEPTION_INFO	Unexpected issue. The carrier has reported an issue with your parcel, but details are unavailable.
4	NOT_YET_RECEIVED_BY_CARRIER	PROCESSING	EXCEPTION_INFO	Warehouse processing delay. There was an issue with your order leaving the warehouse. This may impact your expected delivery date. We are working on resolving this. Your tracking will be updated when the delay is resolved.
5	COLLECTION_REQUESTED	PROCESSING	SYSTEM	Collection requested.
6	COLLECTION_MADE	PROCESSING	HAPPY	Delivery company collected parcel.
7	COLLECTION_FAILED	PROCESSING	EXCEPTION_INFO	Delivery company missed collection.
8	ELEC_ADVICE_RECD_BY_CARRIER	PROCESSING	SYSTEM	Electronic Advice Received.
9	DROPPED_OFF	PROCESSING	HAPPY	Your parcel has been dropped off and is ready for carrier processing.
10	RECEIVED_BY_CARRIER	IN_TRANSIT	HAPPY	Received by delivery company.
11	RECD_BY_CARRIER_NO_ELEC_ADVICE	IN_TRANSIT	EXCEPTION_INFO	Processing issue. The delivery company has reported an issue that may impact your visibility of tracking updates and expected delivery date. They are working on resolving this.
12	ROUTING_ERROR	IN_TRANSIT	EXCEPTION_INFO	Delayed by delivery company. The delivery company is reporting sorting issues that could impact your expected delivery date. Your tracking will be updated when the issue is resolved.
13	CARRIER_DELAYS	IN_TRANSIT	EXCEPTION_INFO	Delayed in transit. The delivery company has reported an issue that may impact your expected delivery date. They are working on resolving this. Your tracking will be updated when the delay is resolved.
14	DELIVERY_RESCHEDULED	OUT_FOR_DELIVERY	EXCEPTION_INFO	Delivery rescheduled. Your parcel's delivery has been rescheduled due to operational issues.
15	DELAYED_NOT_CARRIER	IN_TRANSIT	EXCEPTION_INFO	Delayed. The delivery company is reporting unexpected disruption that could impact your expected delivery date. Your tracking will be updated when the issue is resolved.
16	HELD_BY_CUSTOMS	IN_TRANSIT	EXCEPTION_ACTION	Held at customs. Your delivery is currently being held due to issues with the customs declaration. Your tracking will be updated when the issue is resolved.
17	CUSTOMS_PROCESSING	IN_TRANSIT	HAPPY	Processing at Customs.
18	DUTY_NOT_PAID	IN_TRANSIT	EXCEPTION_ACTION	Issue with customs. The duties for this parcel haven't been paid. Please contact the sender or carrier for assistance, as the shipment may be disposed of by customs authorities if the duties remain unpaid.
19	PARCEL_DAMAGED	IN_TRANSIT	EXCEPTION_INFO	Damaged. Your parcel has been damaged in transit and cannot be delivered. It will be returned to the Seller. Please contact your Seller for more information.
20	RECEIVED_LOCAL_DELIVERY_DEPOT	IN_TRANSIT	HAPPY	Received at local delivery depot.
21	IN_TRANSIT	IN_TRANSIT	HAPPY	In transit.
22	HUB_PROCESSING	IN_TRANSIT	HAPPY	Your parcel is being processed at a carrier hub.
23	HUB_SCAN_IN	IN_TRANSIT	HAPPY	Your parcel has arrived at the carrier's hub for processing.
24	HUB_SCAN_OUT	IN_TRANSIT	HAPPY	Processed at main delivery depot.
25	DELIVERY_ARRANGED_WITH_RECIPIENT	IN_TRANSIT	HAPPY	Delivery rearranged.
26	SUB_CONTRACTOR_EVENT	IN_TRANSIT	SYSTEM	Parcel with local delivery partner.
27	SUB_CONTRACTOR_RECEIVED	IN_TRANSIT	HAPPY	Arrived in destination country.
28	ADDRESS_QUERY	IN_TRANSIT	EXCEPTION_ACTION	Issue with delivery address. This may cause a delay with your delivery or the order being returned back to {brandName}. Please contact {brandName} or the delivery company to confirm the delivery address.
29	CUSTOMS_CLEARED	IN_TRANSIT	HAPPY	Customs cleared.
30	PARCEL_REPACKED	IN_TRANSIT	EXCEPTION_INFO	Repackaged. The delivery company is repackaging your parcel. This could impact your expected delivery date. Your tracking will be updated when the issue is resolved.
31	HELD_BY_CARRIER	IN_TRANSIT	EXCEPTION_INFO	Held by delivery company. The delivery company is reporting disruption that could impact your expected delivery date. Your tracking will be updated when the issue is resolved.
32	INFORMATION	IN_TRANSIT	SYSTEM	Information.
33	INCORRECT_DECLARATION	IN_TRANSIT	EXCEPTION_ACTION	Processing issue. The parcels dimensions do not match those supplied to the delivery company. This may cause a delay with your delivery or the order being returned back to the Seller. Your tracking will be updated when the delay is resolved.
34	PARCEL_REDIRECTED_BY_CARRIER	OUT_FOR_DELIVERY	EXCEPTION_ACTION	Parcel redirected by carrier. The carrier has redirected your parcel due to an operational issue. The package is likely being rerouted to a nearby pickup point. You may contact the carrier for more details about the new delivery location.
35	PARCEL_REDIRECTED_BY_RECIPIENT	OUT_FOR_DELIVERY	HAPPY	Your parcel has been redirected to a new delivery address per your request.
36	HELD_BY_CARRIER_FOR_CLEARANCE_PRE_PROCESSING	IN_TRANSIT	EXCEPTION_ACTION	Held by delivery company. Your delivery is currently being held due to issues with the customs declaration. Please wait for tracking updates.
37	PARCEL_OVER_LABELLED	IN_TRANSIT	SYSTEM	Parcel with local delivery partner.
38	PARCEL_UPDATE_NOTIFICATION	OUT_FOR_DELIVERY	SYSTEM	The carrier has sent you an update on your parcel status via SMS or email.
39	DELIVERY_SCHEDULED	OUT_FOR_DELIVERY	HAPPY	Your parcel's delivery has been scheduled and will soon be out for delivery.
40	OUT_FOR_DELIVERY	OUT_FOR_DELIVERY	HAPPY	Out for delivery.
41	COD_AMOUNT_PAID	OUT_FOR_DELIVERY	SYSTEM	Cash on delivery paid.
42	COD_AMOUNT_NOT_PAID	IN_TRANSIT	EXCEPTION_ACTION	Cash on delivery not paid. You selected to pay on delivery but the payment was not made. The delivery company could not complete the delivery. They may have left instructions or contacted you to explain how to rearrange delivery or collection.
43	NO_ACCESS_TO_RECIPIENTS_ADDRESS	IN_TRANSIT	EXCEPTION_ACTION	No access to delivery address. The delivery company could not complete the delivery due to issues accessing your address. Please follow any instructions sent by the delivery company.
44	CUSTOMER_IDENTIFICATION_FAILED	IN_TRANSIT	EXCEPTION_ACTION	Customer identification failed. There was an issue with identification. Please contact your Seller for more information.
45	CUSTOMER_CARDED	IN_TRANSIT	EXCEPTION_INFO	Delivery attempted, instructions left. The delivery company could not deliver your parcel today. Instructions have been left or provided by the delivery company on how to complete your delivery.
46	ATTEMPTED_DELIVERY	IN_TRANSIT	EXCEPTION_INFO	Delivery attempted.
47	ATTEMPTED_DELIVERY_FINAL	OUT_FOR_DELIVERY	EXCEPTION_ACTION	Final delivery attempt failed. The carrier made a final attempt to deliver your parcel but was unable to complete delivery. Please check the carrier's instructions for next steps.
48	CUSTOMER_TO_COLLECT_FROM_CARRIER	OUT_FOR_DELIVERY	HAPPY	Ready to collect from delivery company.
49	DELIVERED	DELIVERED	HAPPY	Delivered.
50	DELIVERED_TO_PO_BOX	DELIVERED	HAPPY	Delivered to PO Box.
51	DELIVERED_DAMAGED	DELIVERED	EXCEPTION_INFO	Delivered damaged.
52	DELIVERED_IN_PART	DELIVERED	EXCEPTION_INFO	Part of your order delivered. Please check the tracking updates for information on your remaining items.
53	DELIVERED_TO_NEIGHBOUR	DELIVERED	HAPPY	Delivered to neighbour.
54	DELIVERED_SPECIFIED_SAFE_PLACE	DELIVERED	HAPPY	Delivered using your special instructions.
55	PROOF_OF_DELIVERY	DELIVERED	SYSTEM	Proof of delivery received.
56	DELIVERED_TO_ALTERNATIVE_DELIVERY_LOCATION	DELIVERED	EXCEPTION_INFO	Delivered to an alternative address. The delivery company was unable to deliver to the address provided and will provide instructions on where to collect your order.
57	COLLECT_AT_LOCAL_PO	DELIVERED	EXCEPTION_ACTION	Ready to collect from delivery office.
58	DELIVERED_TO_LOCKER_COLLECTION_POINT	READY_TO_COLLECT	HAPPY	Delivered to collection point.
59	AWAITING_COLLECTION_FROM_PICKUP_POINT	READY_TO_COLLECT	HAPPY	Ready to collect.
60	PARCEL_COLLECTED_FROM_PICKUP_POINT	COLLECTED	HAPPY	Collected by customer.
61	DELIVERED_TO_RECEPTION	DELIVERED	HAPPY	Your parcel has been delivered to your building's reception or designated mail area.
62	POST_TRANSIT_STATUS	DELIVERED	SYSTEM	Information.
63	NOT_DELIVERED	NOT_DELIVERED	EXCEPTION_FATAL	All delivery attempts failed. Your parcel could not be delivered, or all delivery attempts have failed. It has been sent back to the Seller, so please contact your Seller for more information.
64	NOT_DELIVERED_ADDRESSEE_DECEASED	NOT_DELIVERED	EXCEPTION_FATAL	Not delivered as addressee deceased.
65	CUSTOMER_MOVED	NOT_DELIVERED	EXCEPTION_ACTION	Customer moved address. The delivery company was told the recipient is no longer at the delivery address. Your parcel will be returned to {brandName}.
66	CANCELLED	NOT_DELIVERED	EXCEPTION_FATAL	Delivery cancelled.
67	REFUSED_BY_CUSTOMER	NOT_DELIVERED	EXCEPTION_ACTION	Delivery refused by customer. The delivery company could not deliver your parcel. It has been returned to the Seller. Please contact your Seller for more information.
68	PARCEL_LOST	NOT_DELIVERED	EXCEPTION_FATAL	Lost in transit. Your parcel has been lost by the delivery company and will not be delivered. Please contact your Seller to discuss what to do next to receive your items.
69	PARCEL_OUTSIDE_OF_SERVICE_CAPABILITY	NOT_DELIVERED	EXCEPTION_FATAL	Processing Issue. Your item(s) were sent using an unsuitable delivery service for the size, weight or value of the parcel. The delivery company cannot deliver this parcel. It will be returned to the Seller. Please contact your Seller for more information.
70	HAZARDOUS_PROHIBITED	NOT_DELIVERED	EXCEPTION_FATAL	Processing issue. Your parcel contained an item the delivery company is prohibited from delivering. Your parcel has been returned to the Seller. Please contact your Seller for more information.
71	PARCEL_DISPOSED	NOT_DELIVERED	EXCEPTION_FATAL	Damaged. This means the delivery company can no longer deliver this parcel. Please contact your Seller to discuss what to do next to receive your items.
72	NOT_COLLECTED_FROM_PICKUP_POINT	NOT_COLLECTED	EXCEPTION_FATAL	Not collected in time. The delivery company has now sent your parcel back to the Seller so it is no longer available to collect.
73	RETURN_TO_SENDER	RETURN_TO_SENDER	EXCEPTION_FATAL	Returned to retailer. Your parcel could not be delivered, or all delivery attempts have failed. It has been sent back to the Seller. Please contact your Seller for more information.
74	UNDELIVERABLE_RETURNED_TO_SENDER	RETURN_TO_SENDER	EXCEPTION_ACTION	Returned to retailer. The shipment has been returned to the sender. Please contact the sender for further information.

Order events

After an order has been accepted, you have the option to start sharing order events with your customers.

Order events can be used to communicate the status of an order before its ready for shipping with a carrier. This can be useful if you have long order or warehouse processing times. This can be common where products are customised or during peak periods where demands increases your pre-ship times.

To reduce complexity, the Tracking API maps all order events into 12 normalised terms that are easier to understand for your support agents and your shoppers.

You can use the order event codes below when adding events for a delivery.

#	Order event code	Status code	Event category	Description / Exception message
1	ORDER_ACCEPTED	ORDER_PROCESSING	HAPPY	Order accepted.
2	PAYMENT_SUCCESSFUL	ORDER_PROCESSING	HAPPY	Payment processed.
3	PAYMENT_DECLINED	ORDER_PROCESSING	EXCEPTION_ACTION	Payment failed.
4	CANCELLED_BEFORE_DESPATCH	CANCELLED_BEFORE_DESPATCH	EXCEPTION_FATAL	Cancelled before despatch. This was cancelled by you or {brandName} and your item(s) will not be delivered. Please contact us if you were not expecting the cancellation.
5	ORDER_DECLINED	CANCELLED_BEFORE_DESPATCH	EXCEPTION_FATAL	Order declined. Your order could not be successfully processed, and your item(s) will not be delivered.
6	PERSONALISATION_STARTED	PERSONALISATION_IN_PROGRESS	HAPPY	Personalisation begun.
7	PERSONALISATION_ISSUE	PERSONALISATION_IN_PROGRESS	EXCEPTION_ACTION	Issue with personalisation. We are currently unable to complete the personalisation of your product. Please contact {brandName} to discuss so we can complete your order.
8	AWAITING_FULFILMENT	PREPARING_FOR_DESPATCH	HAPPY	Order accepted into warehouse.
9	PERSONALISATION_COMPLETED	PREPARING_FOR_DESPATCH	HAPPY	Personalisation completed.
10	READY_FOR_PACKING	PREPARING_FOR_DESPATCH	HAPPY	Ready for packing.
11	DESPATCH_DELAYED	PREPARING_FOR_DESPATCH	EXCEPTION_INFO	Despatch delayed. We had an issue and have not yet shipped your item(s). There may be an impact on your expected delivery date. We are working on resolving this and your tracking will be updated when the delay is resolved.
12	DESPATCH_DELAYED_IN_PART	PREPARING_FOR_DESPATCH	EXCEPTION_INFO	Part of despatch delayed. We had an issue and have not yet shipped some of your item(s). There may be an impact your expected delivery date for the delayed items. We are working on resolving this and your tracking will be updated when the delay is resolved.

Return events

The Tracking API can also be used to track returns.

To reduce complexity, the API maps return events into nine normalised terms that are easier to understand for your support agents and your shoppers.

You can use the return event codes below when adding events for a delivery.

#	Return event code	Status code	Event category	Description / Exception message
1	RETURN_CREATED	RETURN_REQUEST_IN_PROGRESS	HAPPY	Return created.
2	RETURN_NEEDS_APPROVAL	RETURN_REQUEST_IN_PROGRESS	EXCEPTION_ACTION	Return request pending. We are confirming the return can be accepted and will update you shortly.
3	RETURN_APPROVED	RETURN_REQUEST_IN_PROGRESS	HAPPY	Return request approved.
4	RETURN_CANCELLED	RETURN_DECLINED	EXCEPTION_FATAL	Return cancelled. Your return was cancelled by you or {brandName}. Unfortunately, your item(s) can no longer be returned. Please contact us if you were not expecting the cancellation.
5	RETURN_REJECTED	RETURN_DECLINED	EXCEPTION_FATAL	Return request rejected. Unfortunately, your return has not been accepted for a refund or exchange. Please contact us if you were not expecting the request to be rejected.
6	RETURN_WINDOW_EXPIRED	RETURN_DECLINED	EXCEPTION_FATAL	Return policy not met. Unfortunately, your return request does not meet our returns policy, and no refund or exchange can be given. Please contact us if you were not expecting the request to be declined.
7	RETURN_NOT_COMPLETED	RETURN_DECLINED	EXCEPTION_FATAL	Return not completed. Unfortunately, your return has not been accepted for a refund or exchange. Please contact us if you were not expecting the request to be rejected.
8	RETURN_COMPLETED	RETURN_COMPLETED	HAPPY	Return completed.
9	RETURN_COMPLETED_IN_PART	RETURN_COMPLETED	EXCEPTION_INFO	Part of return accepted. Some of the item(s) you have returned have been accepted for refund or exchange. The remaining items do not meet our returns policy, and unfortunately no refund or exchange can be given.