Search Flight API

The Flight Search API allows you to search for available flights between specified origins and destinations with various parameters.

Endpoint

POST /flight/search

Headers

client-id (required): Unique Client ID
client-secret (required): Unique Client Secret
Content-Type (required): application/json

Request Parameters

Parameter	Type	Required	Description
client_referenceId	string	Yes	Unique Client Reference ID
journey_type	string	Yes	Type of journey (oneway, return, multi_trip, advanced, special_return)
adults	integer	Yes	Number of adult passengers
children	integer	Yes	Number of child passengers
infants	integer	Yes	Number of infant passengers
direct_flight	boolean	Yes	Search only direct flights (true/false)
onestop_flight	boolean	Yes	Include one-stop flights (true/false)
journeys	array	Yes	List of journey segments
journeys.*.origin	string	Yes	Departure location code
journeys.*.destination	string	Yes	Arrival location code
journeys.*.cabin_class	string	Yes	Travel class (all, economy, premium_economy, business, premium_business, first)
journeys.*.departure_date	string	Yes	Departure date (YYYY-MM-DD)
journeys.*.arrival_date	string	Conditional	Required for return/special_return journeys
journeys.*.departure_period	string	No	Preferred departure time
journeys.*.arrival_period	string	No	Preferred arrival time
source	string	Conditional	Required if journey_type is special_return
fare_type	string	No	Fare category (student, senior_citizen, armed_forces)

Response

Success Response (200)

{
    "status": "SUCCESS",
    "status_code": "200",
    "message": "Flight data retrieved successfully.",
    "data": {
        "trace_id": "c8812945-36ab-481c-84e6-413aa438f511",
        "origin": "DEL",
        "destination": "BOM",
        "result": [
            {
                "token": "OB1[TBO]BwVNdj4P3j1AoCZQ+gmNK+0thztrQjDuTcA1EcRvENizNi6mw8IvRZBZOqDgt/YWFDvPACpKpP+bpgDFD008yjJrNQeEpOnZrtlczEYT9nR83cHVMntQTtty+JmqCXEaRg5D1RMSeB/GBH+5dY9GTw2fU0pLFWNP3IYGrPc+l9yZnkPgDYeUGDRf/y+TfUG0EfJJ8okrz1riCLL0l6vPHqU1MV2TAM8mkMP5aol/99kxsW+9mtoRKhrCBauxjUTsf3fk8PG19+iPBpOf4BnwxzXUZNxqcFqmIyUO1t6B/idkmsgcsissXNTv/NK6JLs4U+u42/+uyj4fjg777M/xpNFtPEAAez6KEn7WBVDbNwjBT++tt+4KtmztAxfkg3UytbOafNlM6kWe+16Yv/X/1w6eiyRP49Iwj2KbuuL0dO9BaT9Ja953lFPimTFQ9pFThDP4b75AycDv+k24vDBKYc5XXx2uJfLPzQLMhFjARZT8izmSP995al2P59ZUdGIcWvhmUj6qGQ5ArfbC2QLtE4T9hyNvITSXdH9AfkDilNFXxtsMLDRctoN3xcL7waRxq8hwUQ9JxHmvkXykZKAmRFX7j5ciUg29+NOjLvU9mYisc5/1VH/G3FiYNhrVCpkZe/Yrj8EYYEXBghSixtFMxCKZDjjoGBd+KlquKsA4yWY=",
                "source": "Indigo",
                "airline_code": "6E",
                "airline_remark": "6E main, Senior fare result.",
                "validating_airline": "6E",
                "is_lcc": true,
                "free_meal": false,
                "refundable": true,
                "coupon_applicable": true,
                "passport_required_at_book": false,
                "passport_required_at_ticket": false,
                "gst_mandatory": false,
                "segments": [
                    {
                        "trip_indicator": "outbound",
                        "segment_indicator": "outbound",
                        "flight_number": "449",
                        "airline_code": "6E",
                        "airline_name": "Indigo",
                        "fare_class": "QR",
                        "operating_carrier": "",
                        "origin": {
                            "airport_code": "DEL",
                            "airport_name": "Indira Gandhi Airport",
                            "terminal": "1D",
                            "city_code": "DEL",
                            "city_name": "Delhi",
                            "country_code": "IN",
                            "country_name": "India",
                            "departure_time": "2025-06-01 05:00:00"
                        },
                        "destination": {
                            "airport_code": "BOM",
                            "airport_name": "Chhatrapati Shivaji Maharaj International Airport",
                            "terminal": "2",
                            "city_code": "BOM",
                            "city_name": "Mumbai",
                            "country_code": "IN",
                            "country_name": "India",
                            "arrival_time": "2025-06-01 07:10:00"
                        },
                        "duration": "2h 10m",
                        "baggage": {
                            "checked_baggage": "15 Kilograms",
                            "cabin_baggage": "7 KG"
                        },
                        "flight_class": "Saver (Regular)",
                        "is_stopover": false,
                        "e-ticket_available": true,
                        "flight_status": "Confirmed"
                    }
                ],
                "fare_type": "SeniorFare",
                "fare": {
                    "currency": "INR",
                    "basefare": 4662,
                    "tax_and_surcharges": 915,
                    "total_fare": 5577
                },
                "fare_breakdown": [
                    {
                        "currency": "INR",
                        "passenger_type": "adult",
                        "passenger_count": 1,
                        "basefare": 4662
                    }
                ],
                "fare_inclusions": [],
                "fare_rules": [
                    {
                        "origin": "DEL",
                        "destination": "BOM",
                        "airline": "6E",
                        "fare_rules": ""
                    }
                ],
                "mini_fare_rules": [
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Reissue",
                        "from": "0",
                        "to": "3",
                        "unit": "DAYS",
                        "charges": "INR 2999",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    },
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Reissue",
                        "from": "4",
                        "to": "",
                        "unit": "DAYS",
                        "charges": "INR 2250",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    },
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Cancellation",
                        "from": "0",
                        "to": "3",
                        "unit": "DAYS",
                        "charges": "INR 3999",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    },
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Cancellation",
                        "from": "4",
                        "to": "",
                        "unit": "DAYS",
                        "charges": "INR 2999",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    },
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Reissue",
                        "from": "44",
                        "to": "444",
                        "unit": "HOURS",
                        "charges": "Unchangeble",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    }
                ]
            }
        ]
    }
}

Response Fields

Root Level

status: Response status (SUCCESS/FAILED)
status_code: HTTP status code
message: Response message
data: Flight search results data

Data Object

trace_id: Unique trace identifier for the search
origin: Origin airport code
destination: Destination airport code
result: Array of available flight options

Flight Result Object

token: Unique booking token for the flight
source: Airline source
airline_code: IATA airline code
airline_remark: Additional airline information
validating_airline: Validating airline code
is_lcc: Low-cost carrier flag
free_meal: Meal inclusion flag
refundable: Refundability status
coupon_applicable: Coupon applicability
passport_required_at_book: Passport requirement at booking
passport_required_at_ticket: Passport requirement at ticketing
gst_mandatory: GST requirement flag

Segments

Contains detailed flight segment information including:

Origin and destination details
Departure and arrival times
Flight duration
Baggage allowances
Flight class information

Fare Information

fare_type: Type of fare (e.g., SeniorFare)
fare: Base fare, taxes, and total fare
fare_breakdown: Per passenger type breakdown
fare_rules: Detailed fare rules and restrictions
mini_fare_rules: Cancellation and reissue policies

Usage Example

const response = await fetch('/flight/search', {
  method: 'POST',
  headers: {
    'client-id': 'your-client-id',
    'client-secret': 'your-client-secret',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    client_referenceId: "SEARCH123456",
    journey_type: "oneway",
    adults: 1,
    children: 0,
    infants: 0,
    direct_flight: false,
    onestop_flight: true,
    journeys: [{
      origin: "DEL",
      destination: "BOM",
      cabin_class: "economy",
      departure_date: "2025-06-01"
    }]
  })
});

The response includes comprehensive flight information including fare details, baggage allowances, and booking policies to help users make informed decisions.