Merge pull request #369 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)
 

lib/EasyPost/Service/TrackerService.php

@@ -65,4 +65,17 @@ public function create(mixed $params = null): mixed
 
         return self::createResource(self::serviceModelClassName(self::class), $params);
     }
+
+    /**
+     * Retrieve a batch of trackers.
+     *
+     * @param mixed $params
+     * @return mixed
+     */
+    public function retrieveBatch(mixed $params = null): mixed
+    {
+        $response = Requestor::request($this->client, 'post', '/trackers/batch', $params);
+
+        return InternalUtil::convertToEasyPostObject($this->client, $response);
+    }
 }

test/EasyPost/TrackerTest.php

@@ -120,4 +120,22 @@ public function testGetNextPage(): void
             throw $error;
         }
     }
+
+    /**
+     * Test creating a Tracker.
+     */
+    public function testRetrieveBatch(): void
+    {
+        TestUtil::setupCassette('trackers/retrieveBatch.yml');
+
+        $tracker = self::$client->tracker->create([
+            'tracking_code' => 'EZ1000000001',
+        ]);
+
+        $trackers = self::$client->tracker->retrieveBatch([
+            'tracking_codes' => [$tracker->tracking_code]
+        ]);
+
+        $this->assertContainsOnlyInstancesOf(Tracker::class, $trackers['trackers']);
+    }
 }