Flight V8 API | SEARCH | SRDV API Document

SEARCH

This method provides availability information with the cheapest fare option available. The request includes single query. The search request contains optional field of Return Date.

In case of round trip, this field should be filled with the date of return. When properly submitted, the Search Response returns the available option.

Once the requested query is parsed and validated, the booking engine start searching for the best option in all possible sources. If the search is successful it will return Result object.

Service URL (REST) to be used:
Air Search Request
Level Element Format Comments Mandatory
1 EndUserIp String IP address of the user making the search request Mandatory
2 ClientId String Your registered client ID provided by the system Mandatory
3 UserName String Your login username Mandatory
4 Password String Your login password Mandatory
5 AdultCount Integer Number of adult passengers (must be at least 1) Mandatory
6 ChildCount Integer Number of child passengers (if any) Mandatory
7 InfantCount Integer Number of infant passengers (if any) Mandatory
8 JourneyType Integer 1 - OneWay, 2 – Return, 3 – Multi City Mandatory
9 DirectFlight Boolean Set to true if you want only non-stop flights (Value – True or False) Optional
10 SoftwareType Enumeration Type of application (B2B for agents, B2C for customers) Optional
11 FareType String Select special fare type, Possible values : 1 - Normal Fare, 2 - Student Fare, 3 - SeniorCitizen Fare, 4 - ArmedForce Fare Optional
12 Sources String Filter results by specific airlines : SG - Spice Jet, 6E - Indigo, G8 - Go Air, G9 - Air Arabia, FZ - Fly Dubai,
IX - Air India, AK - Air Asia, LB - Air Costa
Optional
13 Segments[] Array List of travel routes (from and to locations) Mandatory
13.1 Origin String Departure city/airport code (e.g., DEL) Mandatory
13.2 Destination String Arrival city/airport code (e.g., BOM) Mandatory
13.3 FlightCabinClass Integer Preferred travel class : 1 - All, 2 - Economy, 3 - PremiumEconomy, 4 - Business, 5 - PremiumBusiness, 6 - First Class Mandatory
13.4 PreferredDepartureTime Date Time Preferred date and time of departure, Format: yyyyMMddTHH:mm:ss
2015-08-10T00:00:00 - Any time 2015-08-10T08:00:00 - Morning Flights 2015-08- 10T14:00:00 - Afternoon Flights
2015-08-10T19:00:00 - Evening Flights
2015-08-10T01:00:00 - Night Flights
Mandatory
13.5 PreferredArrivalTime Date Time Preferred date and time of arrival, Format: yyyyMMddTHH:mm:ss
2015-08-10T00:00:00 - Any time 2015-08-10T08:00:00 - Morning Flights 2015-08- 10T14:00:00 - Afternoon Flights
2015-08-10T19:00:00 - Evening Flights
2015-08-10T01:00:00 - Night Flights
Mandatory
Air Search Response
Level Element Format Comments Mandatory
1 Error{} Object Shows if any error occurred during search Mandatory
1.1 ErrorCode String Code for the error Mandatory
1.2 ErrorMessage String Description of the error Mandatory
2 TraceId Integer Unique ID to track this search request Mandatory
3 SrdvType String Simple result data version Mandatory
4 Origin String Origin city code Mandatory
5 Destination String Destination city code Mandatory
6 Results [ ] Array List of flight search results matching the requested search criteria ( may be empty if no flights are available for the specified route and travel dates. ) Mandatory
6.1 FareDataMultiple [ ] Array Collection of fare options and pricing details available for the flight result. Mandatory
6.1.1 SrdvIndex String Internal SRDV identifier used to track and validate the selected fare option. Mandatory
6.1.2 ResultIndex String Unique identifier for the flight result. Required for Fare Quote, Booking, and Ticketing requests. Mandatory
6.1.3 SingleSlotBooking Enumeration Indicates whether the flight supports booking all passengers under a single booking slot. Mandatory
6.1.4 Source String Source or provider from which the fare is retrieved. Mandatory
6.1.5 ButtonColor String Hex color code used for displaying the fare option button. Mandatory
6.1.6 TextColor String Hex color code used for displaying text associated with the fare option. Mandatory
6.1.7 IsLCC Boolean Indicates whether the airline is a Low-Cost Carrier (LCC). (Value – True or False) Mandatory
6.1.8 IsRefundable Boolean Indicates whether the ticket is eligible for cancellation and refund as per airline rules. (Value – True or False) Mandatory
6.1.9 GSTAllowed Boolean Indicates whether GST details can be provided for this booking. (Value – True or False) Optional
6.1.10 IsGSTMandatory Boolean Indicates whether GST information is mandatory for ticket issuance. (Value – True or False) Optional
6.1.11 AirlineRemark String Additional remarks or advisory messages provided by the airline for this fare. Mandatory
6.1.12 OfferedFare String Final fare offered to the customer after applying all applicable adjustments. Mandatory
6.1.13 Fare{} Object Detailed fare breakdown for the selected flight. Mandatory
6.1.13.1 Currency String Currency code in which all fare amounts are displayed (e.g., INR, USD). Mandatory
6.1.13.2 BaseFare Decimal Base ticket fare before taxes, fees, and surcharges. Mandatory
6.1.13.3 Tax Decimal Total tax amount applicable to the booking. Mandatory
6.1.13.4 YQTax Decimal Fuel surcharge imposed by the airline. Included in the total tax amount. Mandatory
6.1.13.5 OtherCharges Decimal Additional charges imposed by the airline, airport, or regulatory authorities. Mandatory
6.1.13.6 TransactionFee Decimal Transaction or processing fee applicable to the booking. Mandatory
6.1.13.7 AdditionalTxnFeeOfrd Decimal Additional transaction fee included in the offered fare. This amount may be collected from the customer but is not charged by SRDV. Mandatory
6.1.13.8 AdditionalTxnFeePub Decimal Additional transaction fee included in the published fare. This amount may be collected from the customer but is not charged by SRDV. Mandatory
6.1.13.9 AirTransFee Decimal Airline transaction fee applicable to the booking. Mandatory
6.1.13.10 Discount Decimal Total discount applied to the fare. Typically zero for API customers. Mandatory
6.1.13.11 PublishedFare Decimal Total fare published by the airline, including base fare, taxes, and applicable charges. Mandatory
6.1.13.12 OfferedFare Decimal Final fare offered to the customer after applying all applicable fare adjustments, charges, and markups. Mandatory
6.1.13.13 CommissionEarned Decimal Total commission earned by the agent for the booking. Represents the agent's revenue from the transaction. Mandatory
6.1.13.14 TdsOnCommission Decimal Tax Deducted at Source (TDS) applicable to the earned commission. Mandatory
6.1.14 FareBreakdown[] Array Detailed fare breakdown grouped by passenger type (Adult, Child, Infant). Mandatory
6.1.14.1 PassengerType Integer Passenger Type : 1 - Adult, 2 - Child, 3 - Infant Mandatory
6.1.14.2 PassengerCount Integer Total number of passengers belonging to the specified passenger type. Mandatory
6.1.14.3 BaseFare Decimal Total base fare applicable to the specified passenger type before taxes and surcharges. Mandatory
6.1.14.4 Tax Decimal Total tax amount applicable to the specified passenger type. Mandatory
6.1.14.5 YQTax Decimal Fuel surcharge applicable to the specified passenger type. Mandatory
6.1.14.6 AdditionalTxnFeeOfrd Decimal Additional transaction fee included in the offered fare. This amount may be collected from the customer but is not charged by SRDV. Mandatory
6.1.14.7 AdditionalTxnFeePub Decimal Additional transaction fee included in the published fare. This amount may be collected from the customer but is not charged by SRDV. Mandatory
6.1.15 FareSegments[] Array Contains fare details and baggage allowances for each flight segment included in the itinerary. Mandatory
6.1.15.1 AirlineCode String IATA airline code identifying the operating or marketing carrier (e.g., AI, 6E, UK). Mandatory
6.1.15.2 AirlineName String Name of the operating airline. Mandatory
6.1.15.3 FlightNumber String Unique flight number assigned by the airline for the specified segment. Mandatory
6.1.15.4 FromAirportCode String IATA airport code of the departure airport (e.g., DEL, BOM). Mandatory
6.1.15.5 FromCity String Name of the departure city. Mandatory
6.1.15.6 ToAirportCode String IATA airport code of the arrival airport (e.g., DEL, BOM). Mandatory
6.1.15.7 ToCity String Name of the arrival city. Mandatory
6.1.15.8 Baggage String Checked baggage allowance applicable to the flight segment as provided by the airline. Mandatory
6.1.15.9 CabinBaggage String Cabin baggage allowance permitted for the flight segment as provided by the airline. Mandatory
6.1.15.10 FareClass String Booking fare class assigned by the airline for the selected flight segment (e.g., Economy Saver, Business Flex). Mandatory
6.1.15.11 CabinClassName String Name of the cabin class associated with the fare (e.g., Economy, Premium Economy, Business, First). Mandatory
6.1.15.12 CabinClassCode Integer Numeric code representing the cabin class as defined by the airline or fare provider. Mandatory
6.1.15.13 NoOfSeatAvailable Integer Number of seats currently available for booking under the specified fare class. Mandatory
6.1.15.14 IsETicketEligible Boolean Indicates whether the flight segment is eligible for electronic ticket issuance. (Value – True or False) Mandatory
6.1.15.15 CancelBeforeHours String Time threshold before departure during which cancellation charges defined in CancelBeforeHoursCharge are applicable. Mandatory
6.1.15.16 CancelBeforeHoursCharge String Cancellation fee applicable when the booking is cancelled before the specified time threshold. Mandatory
6.1.15.17 ReIssueBeforeHoursCharge String Rescheduling or reissue fee applicable when changes are made before the specified time threshold. Mandatory
6.1.15.18 CancelWithInHours String Time threshold before departure during which cancellation charges defined in CancelWithInHoursCharge are applicable. Mandatory
6.1.15.19 CancelWithInHoursCharge String Cancellation fee applicable when the booking is cancelled within the specified time threshold before departure. Mandatory
6.1.15.20 ReIssueWithInHoursCharge String Rescheduling or reissue fee applicable when changes are made within the specified time threshold before departure. Mandatory
6.2 Segments [ ] Array Collection of flight segments that make up the itinerary. A journey may contain one or more segments depending on stops and connections. Mandatory
6.2.1 TripIndicator Integer Identifies whether the segment belongs to the outbound or inbound journey. 1 - Outbound Journey, 2 - Inbound Journey Mandatory
6.2.2 SegmentIndicator Integer Sequence identifier used to distinguish individual segments within a journey. 1 - Outbound Journey, 2 - Inbound Journey Mandatory
6.2.3 Airline{} Object Contains airline information associated with the flight segment. Mandatory
6.2.3.1 AirlineCode String IATA airline code identifying the carrier (e.g., AI, 6E, UK) Mandatory
6.2.3.2 AirlineName String Full name of the operating or marketing airline. Mandatory
6.2.3.3 FlightNumber String Unique flight number assigned by the airline for the segment. Mandatory
6.2.3.4 OperatingCarrier String Airline responsible for operating the flight. May differ from the marketing carrier in codeshare flights. Mandatory
6.2.4 Origin{} Object Contains departure airport and location details for the flight segment. Mandatory
6.2.4.1 AirportCode String IATA code of the departure airport (e.g., DEL, BOM, JFK). Mandatory
6.2.4.2 AirportName String Full name of the departure airport. Optional
6.2.4.3 Terminal String Departure terminal from which the flight operates. Optional
6.2.4.4 CityCode String Standard city code associated with the departure airport. Mandatory
6.2.4.5 CityName String Name of the departure city. Mandatory
6.2.4.6 CountryCode String ISO country code of the departure location (e.g., IN, US, AE). Mandatory
6.2.4.7 CountryName String Full name of the country associated with the departure location. Mandatory
6.2.5 DepTime Date Time Scheduled departure date and time of the flight segment. Mandatory
6.2.6 Destination{} Object Contains arrival airport and destination location details for the flight segment. Mandatory
6.2.6.1 AirportCode String IATA code of the arrival airport (e.g., DEL, BOM, JFK). Mandatory
6.2.6.2 AirportName String Full name of the arrival airport. Mandatory
6.2.6.3 Terminal String Arrival terminal at the destination airport, if available. Optional
6.2.6.4 CityCode String Standard city code associated with the arrival airport. Mandatory
6.2.6.5 CityName String Name of the destination city. Mandatory
6.2.6.6 CountryCode String ISO country code of the destination country (e.g., IN, US, AE). Mandatory
6.2.6.7 CountryName String Full name of the destination country. Mandatory
6.2.7 ArrTime Date Time Scheduled arrival date and time of the flight segment. Mandatory
6.2.8 Duration Time Total flying time for the segment. If unavailable, refer to AccumulatedDuration for the complete journey duration. Optional
6.2.9 GroundTime Time Layover duration between consecutive flight segments at a transit airport. Optional
6.2.10 AccumulatedDuration Time Total journey duration, including flight time and layovers across all segments. Optional
6.2.11 Mile String Total distance covered by the flight segment, typically expressed in miles. Optional
6.2.12 StopOver String Indicates whether the flight includes a stopover or transit point. Optional
6.2.13 StopPointArrivalTime Date Time Scheduled arrival date and time at the stopover location. Optional
6.2.14 StopPointDepartureTime Date Time Scheduled departure date and time from the stopover location. Optional
6.2.15 Craft String Aircraft type or equipment operating the flight segment (e.g., Airbus A320, Boeing 737-800). Optional
6.2.16 Remark String Additional information, operational notes, or airline-specific remarks related to the flight segment. Optional
6.2.17 FlightStatus String Current operational status of the flight segment (e.g., Scheduled, Delayed, Cancelled). Mandatory
6.2.18 Status String Availability status of the flight or fare returned by the airline system. Mandatory
6.2.19 StopPoint String Airport or city code representing the stopover location. Optional
6.3 AirlineCode String IATA airline code of the validating or operating carrier (e.g., AI, 6E, UK). Mandatory
6.4 ValidatingAirline String Airline responsible for validating and issuing the ticket for the itinerary. Mandatory
6.5 OfferedFare String Final fare offered to the customer for the selected flight itinerary, including applicable taxes and charges. Mandatory