Retrieve EasyPost Shipment events and reconcile delivery statuses in bulk

Steps

1. Use GET /v2/shipments with query parameters such as purchased=true and page_size (max 100) to retrieve a page of purchased shipments
2. Paginate through results using the before_id parameter set to the last shipment ID from the previous page until the has_more field is false
3. For each shipment, inspect the tracking_code, status, and tracking_details array — tracking_details entries represent individual scan events with datetime, message, and location
4. Cross-reference shipment status values (pre_transit, in_transit, out_for_delivery, delivered, return_to_sender, failure, unknown) against your internal order management system
5. For high-volume reconciliation, prefer using EasyPost webhooks (Tracker events) to receive push updates rather than polling the shipments list endpoint