Get trust by trust reference number

Dfe.Academies.Api.Infrastructure/Repositories/TrustRepository.cs

@@ -15,15 +15,24 @@ public TrustRepository(MstrContext context) : base(context)
         {
             var trust = await dbSet
                 .Include(x => x.TrustType)
-                .SingleOrDefaultAsync(x => x.UKPRN == ukprn).ConfigureAwait(false);
+                .SingleOrDefaultAsync(x => x.UKPRN == ukprn, cancellationToken).ConfigureAwait(false);
 
             return trust;
         }
         public async Task<Trust?> GetTrustByCompaniesHouseNumber(string companiesHouseNumber, CancellationToken cancellationToken)
         {
             var trust = await dbSet
                 .Include(x => x.TrustType)
-                .SingleOrDefaultAsync(x => x.CompaniesHouseNumber == companiesHouseNumber).ConfigureAwait(false);
+                .SingleOrDefaultAsync(x => x.CompaniesHouseNumber == companiesHouseNumber, cancellationToken).ConfigureAwait(false);
+
+            return trust;
+        }
+
+        public async Task<Trust?> GetTrustByTrustReferenceNumber(string trustReferenceNumber, CancellationToken cancellationToken)
+        {
+            var trust = await dbSet
+                .Include(x => x.TrustType)
+                .SingleOrDefaultAsync(x => x.GroupID == trustReferenceNumber, cancellationToken).ConfigureAwait(false);
 
             return trust;
         }

Dfe.Academies.Application/Queries/Trust/ITrustQueries.cs

@@ -6,6 +6,7 @@ public interface ITrustQueries
     {
         Task<TrustDto?> GetByUkprn(string ukprn, CancellationToken cancellationToken);
         Task<TrustDto?> GetByCompaniesHouseNumber(string companiesHouseNumber, CancellationToken cancellationToken);
+        Task<TrustDto?> GetByTrustReferenceNumber(string trustReferenceNumber, CancellationToken cancellationToken);
         Task<List<TrustDto>> GetByUkprns(string[] ukprns, CancellationToken cancellationToken);
         Task<(List<TrustDto>, int)> Search(int page, int count, string name, string ukPrn, string companiesHouseNumber, CancellationToken cancellationToken);
     }

Dfe.Academies.Application/Queries/Trust/TrustQueries.cs

@@ -36,6 +36,12 @@ public async Task<List<TrustDto>> GetByUkprns(string[] ukprns, CancellationToken
 
             return trusts.Select(x => MapToTrustDto(x)).ToList();
         }
+        public async Task<TrustDto?> GetByTrustReferenceNumber(string trustReferenceNumber, CancellationToken cancellationToken)
+        {
+            var trust = await _trustRepository.GetTrustByTrustReferenceNumber(trustReferenceNumber, cancellationToken).ConfigureAwait(false);
+            return trust == null ? null : MapToTrustDto(trust);
+        }
+
         private static TrustDto MapToTrustDto(Domain.Trust.Trust trust)
         {
             return new TrustDto()

Dfe.Academies.Domain/Trust/ITrustRepository.cs

@@ -6,6 +6,7 @@ public interface ITrustRepository : IGenericRepository<Trust>
     {
         Task<Trust?> GetTrustByUkprn(string ukprn, CancellationToken cancellationToken);
         Task<Trust?> GetTrustByCompaniesHouseNumber(string companiesHouseNumber, CancellationToken cancellationToken);
+        Task<Trust?> GetTrustByTrustReferenceNumber(string trustReferenceNumber, CancellationToken cancellationToken);
         Task<List<Trust>> GetTrustsByUkprns(string[] ukprns, CancellationToken cancellationToken);
         Task<(List<Trust>, int)> Search(int page, int count, string name, string ukPrn,
          string companiesHouseNumber, CancellationToken cancellationToken);

TramsDataApi/Controllers/V4/TrustsController.cs

@@ -83,6 +83,33 @@ public async Task<ActionResult<TrustDto>> GetTrustByCompaniesHouseNumber(string
             return Ok(trust);
         }
 
+        /// <summary>
+        /// Retrieves a Trust by its Companies House Number.
+        /// </summary>
+        /// <param name="companiesHouseNumber">The Companies House Number identifier.</param>
+        /// <param name="cancellationToken"></param>
+        /// <returns>A Trust or NotFound if not available.</returns>
+        [HttpGet]
+        [Route("trust/trustReferenceNumber/{trustReferenceNumber}")]
+        [SwaggerOperation(Summary = "Retrieve Trust by Trust Reference Number also know as the GIAS Group ID", Description = "Retrieve Trust by Trust Reference Number also know as the GIAS Group ID.")]
+        [SwaggerResponse(200, "Successfully found and returned the Trust.")]
+        [SwaggerResponse(404, "Trust with specified Trust Reference Number not found.")]
+        public async Task<ActionResult<TrustDto>> GetTrustByTrustReferenceNumber(string trustReferenceNumber, CancellationToken cancellationToken)
+        {
+            _logger.LogInformation($"Attempting to get trust by Trust Reference Number {trustReferenceNumber}");
+            var trust = await _trustQueries.GetByTrustReferenceNumber(trustReferenceNumber, cancellationToken).ConfigureAwait(false);
+
+            if (trust == null)
+            {
+                _logger.LogInformation($"No trust found for Trust Reference Number {trustReferenceNumber}");
+                return NotFound();
+            }
+
+            _logger.LogInformation($"Returning trust found by Trust Reference Number {trustReferenceNumber}");
+            _logger.LogDebug(JsonSerializer.Serialize(trust));
+            return Ok(trust);
+        }
+
         /// <summary>
         /// Searches for Trusts based on query parameters.
         /// </summary>