Merge pull request #631 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
 - Disposes of Luma service after use
 
 ## v7.2.0 (2025-06-18)

EasyPost.Tests/ServicesTests/TrackerServiceTest.cs

@@ -1,4 +1,3 @@
-using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
 using EasyPost.Exceptions.General;
@@ -148,6 +147,26 @@ public async Task TestRetrieve()
             Assert.Equal(tracker.Id, retrievedTracker.Id);
         }
 
+        [Fact]
+        [CrudOperations.Read]
+        [Testing.Function]
+        public async Task TestRetrieveBatch()
+        {
+            UseVCR("retrieve_batch");
+
+            Tracker tracker = await Client.Tracker.Create(Fixtures.Usps, "EZ1000000001");
+
+            List<string> trackingCodes = new() { tracker.TrackingCode };
+            TrackerCollection trackerCollection = await Client.Tracker.RetrieveBatch(new Dictionary<string, object> { { "tracking_codes", trackingCodes } });
+
+            List<Tracker> trackers = trackerCollection.Trackers;
+
+            foreach (Tracker singleTracker in trackers)
+            {
+                Assert.IsType<Tracker>(singleTracker);
+            }
+        }
+
         #endregion
 
         #endregion

EasyPost.Tests/cassettes/net/tracker_service/retrieve_batch.json

@@ -114,6 +114,19 @@ public async Task<TrackerCollection> All(Parameters.Tracker.All parameters, Canc
         [CrudOperations.Read]
         public async Task<Tracker> Retrieve(string id, CancellationToken cancellationToken = default) => await RequestAsync<Tracker>(Method.Get, $"trackers/{id}", cancellationToken);
 
+        /// <summary>
+        ///     Retrieves a batch of <see cref="Tracker"/>s.
+        /// </summary>
+        /// <param name="parameters">A dictionary of parameters to filter the list of <see cref="Tracker"/>s with.</param>
+        /// <param name="cancellationToken"><see cref="CancellationToken"/> to use for the HTTP request.</param>
+        /// <returns>A <see cref="TrackerCollection"/> instance.</returns>
+        [CrudOperations.Read]
+        public async Task<TrackerCollection> RetrieveBatch(Dictionary<string, object>? parameters = null, CancellationToken cancellationToken = default)
+        {
+            TrackerCollection collection = await RequestAsync<TrackerCollection>(Method.Post, "trackers/batch", cancellationToken, parameters);
+            return collection;
+        }
+
         #endregion
     }
 }