searchSupplierFlights API

Overview

Serves a static third-party flight supplier response structure (simulating Amadeus / GDS Flight Supplier APIs) for listing available flights, airline information, duration, segments, baggage allowance, and fares.

• Controller: searchSupplierFlights
• Endpoint: /api/supplier/flights/search
• Method: POST

Request Parameters (req.body)

Parameter	Type	Required	Description
origin	String	No	Origin IATA airport code (e.g. "DEL")
destination	String	No	Destination IATA airport code (e.g. "BOM")
departureDate	String	No	Departure date (YYYY-MM-DD)
travelClass	String	No	Cabin class (Default: "ECONOMY")

Response Body Example (200 OK)

{
  "success": true,
  "data": {
    "status": "SUCCESS",
    "searchTraceId": "SUP-FLT-TRACE-99114433",
    "supplier": {
      "code": "AMADEUS_FLIGHTS_MOCK",
      "name": "Amadeus / GDS Flight Supplier",
      "currency": "INR",
      "responseTimeMs": 58
    },
    "searchParameters": {
      "origin": "DEL",
      "originCity": "New Delhi",
      "destination": "BOM",
      "destinationCity": "Mumbai",
      "departureDate": "2026-10-01",
      "passengers": { "adults": 1, "children": 0, "infants": 0 },
      "travelClass": "ECONOMY"
    },
    "flights": [
      {
        "flightResultId": "RES-AI-101",
        "validatingAirline": "AI",
        "airlineName": "Air India",
        "isRefundable": true,
        "totalDurationMinutes": 130,
        "stops": 0,
        "fareDetails": {
          "baseFare": 4500,
          "taxesAndFees": 850,
          "totalNetFare": 5350,
          "currency": "INR"
        },
        "rateKey": "RK_FLT_DEL_BOM_AI101_20261001",
        "segments": [
          {
            "segmentOrder": 1,
            "airlineCode": "AI",
            "flightNumber": "AI-502",
            "origin": { "airportCode": "DEL", "airportName": "Indira Gandhi International Airport", "city": "New Delhi", "terminal": "T3" },
            "destination": { "airportCode": "BOM", "airportName": "Chhatrapati Shivaji Maharaj International Airport", "city": "Mumbai", "terminal": "T2" },
            "departureTime": "2026-10-01T08:00:00+05:30",
            "arrivalTime": "2026-10-01T10:10:00+05:30",
            "durationMinutes": 130,
            "cabinClass": "ECONOMY",
            "baggageAllowance": { "checkIn": "15 KG", "cabin": "7 KG" }
          }
        ]
      }
    ]
  },
  "message": "Static third-party flight supplier response fetched successfully"
}