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

feat: adds retrieveBatch tracker function

Author: Justintime50

CHANGELOG.md

@@ -3,13 +3,14 @@
 ## Next Release
 
 - Adds support for `UspsShipAccount`
+- Adds `Tracker.retrieveBatch` function
 
 ## v8.2.0 (2025-06-18)
 
 - Adds the following functions
-  - `shipment.createAndBuyLuma`
-  - `shipment.buyLuma`
-  - `luma.getPromise`
+  - `Shipment.createAndBuyLuma`
+  - `Shipment.buyLuma`
+  - `Luma.getPromise`
 
 ## v8.1.0 (2025-05-29)
 

src/services/tracker_service.js

@@ -57,4 +57,21 @@ export default (easypostClient) =>
 
       return this._retrieve(url);
     }
+
+    /**
+     * Retrieve a batch of {@link Tracker trackers}.
+     * @param {Object} [params] - The parameters to filter the trackers by.
+     * @returns {Object} - An object containing the list of {@link Tracker trackers}.
+     */
+    static async retrieveBatch(params = {}) {
+      const url = 'trackers/batch';
+
+      try {
+        const response = await easypostClient._post(url, params);
+
+        return this._convertToEasyPostObject(response.body, params);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    }
   };

test/cassettes/Tracker-Service_4233073632/retrieves-a-batch-of-trackers_745559199/recording.har

@@ -70,4 +70,18 @@ describe('Tracker Service', function () {
       }
     }
   });
+
+  it('retrieves a batch of trackers', async function () {
+    const tracker = await client.Tracker.create({
+      tracking_code: 'EZ1000000001',
+    });
+
+    const trackers = await client.Tracker.retrieveBatch({
+      tracking_codes: [tracker.tracking_code],
+    });
+
+    trackers.trackers.forEach((tracker) => {
+      expect(tracker).to.be.an.instanceOf(Tracker);
+    });
+  });
 });