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 |