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

feat: add retrieve_batch tracker function

Author: Justintime50

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## Next Release
 
 - Adds `UspsShipAccount` support to the create carrier method
+- Adds `tracker.retrieve_batch` function
 
 ## v10.1.0 (2025-06-18)
 

easypost/services/tracker_service.py

@@ -4,7 +4,12 @@
 )
 
 from easypost.constant import _FILTERS_KEY
+from easypost.easypost_object import convert_to_easypost_object
 from easypost.models import Tracker
+from easypost.requestor import (
+    RequestMethod,
+    Requestor,
+)
 from easypost.services.base_service import BaseService
 
 
@@ -31,6 +36,14 @@ def all(self, **params) -> dict[str, Any]:
 
         return self._all_resources(self._model_class, filters, **params)
 
+    def retrieve_batch(self, **params) -> Tracker:
+        """Retrieve a batch of Trackers."""
+        url = "/trackers/batch"
+
+        response = Requestor(self._client).request(method=RequestMethod.POST, url=url, params=params)
+
+        return convert_to_easypost_object(response=response)
+
     def retrieve(self, id: str) -> Tracker:
         """Retrieve a Tracker."""
         return self._retrieve_resource(self._model_class, id)

tests/cassettes/test_tracker_retrieve_batch.yaml

@@ -38,6 +38,17 @@ def test_tracker_all(page_size, test_client):
     assert all(isinstance(tracker, Tracker) for tracker in trackers_array)
 
 
+@pytest.mark.vcr()
+def test_tracker_retrieve_batch(page_size, test_client):
+    tracker = test_client.tracker.create(tracking_code="EZ1000000001")
+
+    trackers = test_client.tracker.retrieve_batch(tracking_codes=[tracker.tracking_code])
+
+    trackers_array = trackers["trackers"]
+
+    assert all(isinstance(tracker, Tracker) for tracker in trackers_array)
+
+
 @pytest.mark.vcr()
 def test_tracker_get_next_page(page_size, test_client):
     try: