Merge pull request #358 from EasyPost/SHPE-483_batch_trackers

feat: add retrieveBatch tracker function

Author: Justintime50

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## Next Release
 
 - Adds support for `UspsShipAccount`
+- Adds `tracker.retrieveBatch` function
 
 ## v8.2.0 (2025-06-18)
 

src/main/java/com/easypost/service/TrackerService.java

@@ -100,4 +100,20 @@ public TrackerCollection apply(Map<String, Object> parameters) {
             }
         }, collection.getTrackers(), pageSize);
     }
+
+    /**
+     * Retrieve a batch of Tracker objects.
+     *
+     * @param params Map of parameters used to filter the list of Trackers.
+     * @return TrackerCollection object.
+     * @throws EasyPostException when the request fails.
+     */
+    public TrackerCollection retrieveBatch(final Map<String, Object> params) throws EasyPostException {
+        String endpoint = "trackers/batch";
+
+        TrackerCollection trackerCollection =
+                Requestor.request(RequestMethod.POST, endpoint, params, TrackerCollection.class, client);
+
+        return trackerCollection;
+    }
 }

src/test/cassettes/tracker/retrieve_batch.json

@@ -207,4 +207,25 @@ public Map<String, Object> getNextPageParams() throws EndOfPaginationError {
         assertEquals(trackingCode, nextPageParams.get("tracking_code"));
         assertEquals(carrier, nextPageParams.get("carrier"));
     }
+
+    /**
+     * Test retrieving a batch of trackers.
+     *
+     * @throws EasyPostException when the request fails.
+     */
+    @Test
+    public void testRetrieveBatch() throws EasyPostException {
+        vcr.setUpTest("retrieve_batch");
+
+        Tracker tracker = createBasicTracker();
+
+        Map<String, Object> params = new HashMap<>();
+        params.put("tracking_codes", ImmutableList.of(tracker.getTrackingCode()));
+
+        TrackerCollection trackers = vcr.client.tracker.retrieveBatch(params);
+
+        List<Tracker> trackersList = trackers.getTrackers();
+
+        assertTrue(trackersList.stream().allMatch(singleTracker -> singleTracker != null));
+    }
 }