Release Notes

Version 2.0.0

Release Date: March 2026

Major Changes

New REST API Implementation

• Complete rewrite using .NET 8.0
• Migrated from AWS Lambda to ECS Fargate
• New RESTful architecture

API Version Update

• API version updated from v1 to v2
• New base path: /flight/newskies/availability/v2

New Features

Enhanced Search Capabilities

• Date range search for outbound and inbound flights
• Multi-airport support
• Country-level search
• Carrier filtering
• Result grouping by origin-destination or date
• Result limiting with LimitGroups and LimitFlights parameters

Improved Response Structure

• Grouped flight results
• Comprehensive fare details including gross/net pricing
• Separate pricing for adults, children, and infants
• Encrypted journey and fare keys
• Stopover flight information (up to 2 stopovers)

Authentication & Security

• OAuth 2.0 authentication
• Role-based pricing based on agent credentials
• Encrypted identifiers for booking operations

Technical Enhancements

• .NET 8.0 framework
• FluentValidation for request validation
• Health checks at /health endpoint
• OpenAPI/Swagger documentation
• XML documentation

Infrastructure

• AWS ECS Fargate containerized deployment
• Application Load Balancer
• CloudWatch monitoring
• Parameter Store for configuration
• ECR container registry

Breaking Changes from v1

⚠️ Important: v2 is not backward compatible with v1. Key differences:

1. Base Path Changed: /availability → /flight/newskies/availability/v2
2. Authentication: OAuth 2.0 required
3. Response Structure: Results now grouped (previously flat array)
4. Parameter Names: Some parameters renamed:
   • passengerCount → PassengerCount
   • groupBy → GroupBy
   • limitGroups → LimitGroups
   • limitFlights → LimitFlights
5. Date Format: Strictly enforced yyyy-MM-dd format
6. Trip Type: Uses integer enum (0=Oneway, 1=RoundTrip)

Migration Guide

For applications currently using v1:

1. Update base URL to v2 path
2. Implement OAuth 2.0 authentication
3. Update response parsing for grouped structure
4. Update parameter names