How to identify an undeliverable shipment that is returning back to the origin?

Created by Jhonathan Ibanez, Modified on Thu, 12 Oct, 2023 at 12:42 PM by Jhonathan Ibanez

The Shipment Tracking - Unified API has implemented a new functionality that allows users to know when a shipment didn't have a successful delivery and it's then returning to its origin.


You will identify this by a simple flag like the following: "returnFlag": true,


This flag will only appear when the shipment has been identified as a return. Then, if the shipment had a standard delivery, the flag won't appear marking it as false; it simply won't appear at all.


The return flag functionality doesn't yet support parcel Germany shipments ("service": "parcel-de")



Note that these types of returns don't include the case when a customer isn't satisfied with a product and decides to return it; that process usually includes two tracking IDs, one for the initial delivery label and another for the return.


If you detect an issue with this new flag where shipments are incorrectly marked as returns, or an undeliverable shipment is missing the return flag, please open a ticket on our Help Center and let us know. We are striving to improve our systems constantly.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article