> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api.leanmile.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.leanmile.com/_mcp/server.

# Overview

Lists all new tracking events since last query, or starting from first parcel event time at first query.

Location code is arbitrary and depends on destination country.

eventCode column mostly should contain a computed value, which is converted from courier event messages to be unified acress couriers.\
We are constantly monitoring and updating our algorithm responsible for the conversion to improve tracking data quality.\
We might send an updated information about an event (including changes in eventCode), **you should use eventID column to check update existing events on your system.**

Most used event codes are described here:

<table>
  <tbody><tr><th>Event Code</th><th>Event Description</th></tr><tr><td><b>PARCEL\_REGISTRATION</b></td><td><b>Parcel registration on platform</b></td></tr><tr><td>FIRST\_MILE\_SCAN</td><td>First-mile operations scan</td></tr><tr><td><b>RECEIVE\_ITEM\_AT\_TERMINAL</b></td><td><b>Receive item at processing hub (Inb). Transit stopclock start event</b></td></tr><tr><td><b>ITEM\_DEPARTED\_FROM\_TERMINAL</b></td><td><b>Item departed from terminal (Otb) - postal eq insert item into bag. Terminal handling completed.</b></td></tr><tr><td>SEND\_RECEPTACLE\_ABROAD</td><td>Send item abroad (EDI-received)</td></tr><tr><td>ON\_TRANSPORT\_TO\_DEST\_COUNTRY</td><td>On transportation to destination country</td></tr><tr><td>RECEIVE\_BAG\_AT\_DEST\_DISTR\_HUB</td><td>Bag arrived at destination country, items not scanned. Airport scan if available</td></tr><tr><td>RECEIVE\_ITEM\_EDI\_AT\_DEST\_DISTR\_HUB</td><td>Item EDI scanned at destination country. First physical event from carrier. Stopclock end for unregistered mail.</td></tr><tr><td>STOP\_ITEM\_IMPORT\_AT\_DEST</td><td>Stop item import (customs)</td></tr><tr><td>RECEIVE\_ITEM\_AT\_DEST\_DISTR\_HUB</td><td>Item received and scanned at destination distribution hub.</td></tr><tr><td>HANDOVER\_ITEM\_TO\_DELIVERY\_AGENT</td><td>Handover to delivery agent at destination</td></tr><tr><td><b>SEND\_ITEM\_TO\_DEST\_CUSTOMS</b></td><td><b>Send item for customs clearance at destination. Customs clearance stopclock start.</b></td></tr><tr><td><b>RECORD\_ITEM\_DEST\_CUSTOMS\_INFO</b></td><td><b>Record item for info for clearance at customs.</b></td></tr><tr><td><b>RETURN\_ITEM\_DEST\_FROM\_CUSTOMS</b></td><td><b>Receive item resolution from customs. Customs clearance stopclock end.</b></td></tr><tr><td>HOLD\_ITEM\_AT\_DEST\_DISTR</td><td>Hold item at destination distribution hub</td></tr><tr><td>RECEIVE\_ITEM\_AT\_DEST\_DELIVERY\_OFFICE</td><td>Receive item at destination delivery office</td></tr><tr><td>RECEIVE\_ITEM\_AT\_DEST\_SORTING\_CENTRE</td><td>Receive item at destination sorting center</td></tr><tr><td>SEND\_ITEM\_TO\_DEST\_DOMESTIC\_LOCATION</td><td>Send item for domestic location</td></tr><tr><td>SEND\_ITEM\_OUT\_DEST\_FOR\_PHYSICAL\_DELIVERY</td><td>Send item for domestic distribution</td></tr><tr><td>RECEIVE\_ITEM\_AT\_DEST\_COLLECTION\_POINT\_FOR\_PICK\_UP</td><td>Item ready for pickup at pickup point</td></tr><tr><td>UNSUCCESSFUL\_ITEM\_DELIVERY\_ATTEMPT</td><td>Delivery attempt</td></tr><tr><td>INCORRECT\_ADDRESS</td><td>Incorrect address</td></tr><tr><td>ADDRESS\_CORRECTION</td><td>Address correction performed</td></tr><tr><td>ZIP\_CODE\_CORRECTION</td><td>Zip code correction perfromed</td></tr><tr><td>DELIVERED</td><td>Delivered</td></tr><tr><td>RETURN\_BY\_DESTINATION\_COUNTRY</td><td>Return by destination country</td></tr><tr><td>RETURN\_TO\_SENDING\_COUNTRY</td><td>Return by sending country</td></tr><tr><td>PARCEL\_RESEND</td><td>Resend parcel for delivery</td></tr><tr><td>WAITING\_FOR\_PAYMENT</td><td>Waiting for payment</td></tr><tr><td>RETURNED\_TO\_SENDER</td><td>Returned to sender</td></tr><tr><td>RETURNED</td><td>Returned</td></tr><tr><td>RETURNING</td><td>Returning</td></tr><tr><td>PARCEL\_DESTROYED\_AT\_HUB</td><td>Parcel destoryed at distrbution hub</td></tr><tr><td>DELIVERY\_CANCELLED</td><td>Delivery cancelled</td></tr><tr><td>TRANSIT\_CANCELLED</td><td>Transit cancelled</td></tr></tbody>
</table>