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 available flights ( Can be blank in case no flights found for requested search ) | Mandatory |
| 6.1 | FareDataMultiple [ ] | Array | Collection of fare information | Mandatory |
| 6.1.1 | SrdvIndex | String | Simple result data version index | Mandatory |
| 6.1.2 | ResultIndex | String | Result Index | Mandatory |
| 6.1.3 | SingleSlotBooking | Enumeration | Single Slot Booking Status | Mandatory |
| 6.1.4 | Source | String | Fare Type | Mandatory |
| 6.1.5 | ButtonColor | String | Button Color | Mandatory |
| 6.1.6 | TextColor | String | Text Color | Mandatory |
| 6.1.7 | IsLCC | Boolean | Shows if the airline is low-cost or full-service (Value – True or False) | Mandatory |
| 6.1.8 | IsRefundable | Boolean | Indicates whether the ticket can be refunded (Value – True or False) | Mandatory |
| 6.1.9 | GSTAllowed | Boolean | GST Allowed | Optional |
| 6.1.10 | IsGSTMandatory | Boolean | Is GST Mandatory | Optional |
| 6.1.11 | AirlineRemark | String | Airline Remark | Mandatory |
| 6.1.12 | OfferedFare | String | Offered Fare | Mandatory |
| 6.1.13 | Fare{} | Object | Fare | Mandatory |
| 6.1.13.1 | Currency | String | Currency | Mandatory |
| 6.1.13.2 | BaseFare | Decimal | The total Base fare of the booking | Mandatory |
| 6.1.13.3 | Tax | Decimal | The total tax of the booking | Mandatory |
| 6.1.13.4 | YQTax | Decimal | It is Fuel surcharge.It is part of Tax | Mandatory |
| 6.1.13.5 | OtherCharges | Decimal | Some additional charge by airline/airport. | Mandatory |
| 6.1.13.6 | TransactionFee | Decimal | Transaction fee | Mandatory |
| 6.1.13.7 | AdditionalTxnFeeOfrd | Decimal | It is additional Transaction fee that API User can charge from the customer but SRDV will not charge it from you as per airline | Mandatory |
| 6.1.13.8 | AdditionalTxnFeePub | Decimal | It is additional Transaction fee that API User can charge from the customer but SRDV will not charge it from you as per airline | Mandatory |
| 6.1.13.9 | AirTransFee | Decimal | Air trans fee | Mandatory |
| 6.1.13.10 | Discount | Decimal | The total discount amount of the booking. Will be zero for API customer. | Mandatory |
| 6.1.13.11 | PublishedFare | Decimal | Published Fare | Mandatory |
| 6.1.13.12 | OfferedFare | Decimal | Offered Fare | Mandatory |
| 6.1.13.13 | CommissionEarned | Decimal | Total Commission of Agent. Basically it is your profit margin, earning from booking. | Mandatory |
| 6.1.13.14 | TdsOnCommission | Decimal | TDS on the commission earned. | Mandatory |
| 6.1.14 | FareBreakdown[] | Array | Details of fare breakup into several part. It give fare of Each Passenger Type | Mandatory |
| 6.1.14.1 | PassengerType | Integer | Passenger Type : 1 - Adult, 2 - Child, 3 - Infant | Mandatory |
| 6.1.14.2 | PassengerCount | Integer | Number of Passenger | Mandatory |
| 6.1.14.3 | BaseFare | Decimal | The total Base fare of the booking for particular pax type | Mandatory |
| 6.1.14.4 | Tax | Decimal | The total tax of the booking for particular pax type | Mandatory |
| 6.1.14.5 | YQTax | Decimal | Fuel Surcharge for particular pax type | Mandatory |
| 6.1.14.6 | AdditionalTxnFeeOfrd | Decimal | It is additional Transaction fee that API User can charge from the customer but SRDV will not charge it from you as per airline | Mandatory |
| 6.1.14.7 | AdditionalTxnFeePub | Decimal | It is additional Transaction fee that API User can charge from the customer but SRDV will not charge it from you as per airline | Mandatory |
| 6.1.15 | FareSegments[] | Array | Contains all fare details | Mandatory |
| 6.1.15.1 | AirlineCode | String | Airline Code | Mandatory |
| 6.1.15.2 | AirlineName | String | Airline Name | Mandatory |
| 6.1.15.3 | FlightNumber | String | Flight Number | Mandatory |
| 6.1.15.4 | FromAirportCode | String | From Airport Code | Mandatory |
| 6.1.15.5 | FromCity | String | From City | Mandatory |
| 6.1.15.6 | ToAirportCode | String | To Airport Code | Mandatory |
| 6.1.15.7 | ToCity | String | To City | Mandatory |
| 6.1.15.8 | Baggage | String | Baggage | Mandatory |
| 6.1.15.9 | CabinBaggage | String | Cabin Baggage | Mandatory |
| 6.1.15.10 | FareClass | String | Fare Class | Mandatory |
| 6.1.15.11 | CabinClassName | Integer | Name Of Cabin Class | Mandatory |
| 6.1.15.12 | CabinClassCode | Integer | Cabin Class Code | Mandatory |
| 6.1.15.13 | NoOfSeatAvailable | String | No of Seat Available | Mandatory |
| 6.1.15.14 | IsETicketEligible | Boolean | Is E-Ticket eligible (Value – true or false) | Mandatory |
| 6.1.15.15 | CancelBeforeHours | String | Cancel Before Hours | Mandatory |
| 6.1.15.16 | CancelBeforeHoursCharge | String | Cancel Before Hours Charge | Mandatory |
| 6.1.15.17 | ReIssueBeforeHoursCharge | String | ReIssue Before Hours Charge | Mandatory |
| 6.1.15.18 | CancelWithInHours | String | Cancel Within Hours | Mandatory |
| 6.1.15.19 | CancelWithInHoursCharge | String | Cancel Within Hours Charge | Mandatory |
| 6.1.15.20 | ReIssueWithInHoursCharge | String | ReIssue Within Hours Charge | Mandatory |
| 6.2 | Segments [ ] | Array | Array of Segments (Can be blank in case no flights found for requested search) | Mandatory |
| 6.2.1 | TripIndicator | Integer | Trip Indicator 1 - Outbound, 2 - Inbound flights | Mandatory |
| 6.2.2 | SegmentIndicator | Integer | Segment Indicator 1 - Outbound, 2 - Inbound flights | Mandatory |
| 6.2.3 | Airline{} | Object | Airline | Mandatory |
| 6.2.3.1 | AirlineCode | String | Airline code | Mandatory |
| 6.2.3.2 | AirlineName | String | Airline Name | Mandatory |
| 6.2.3.3 | FlightNumber | String | Flight Number | Mandatory |
| 6.2.3.4 | OperatingCarrier | String | Operating carrier | Mandatory |
| 6.2.4 | Origin{} | Object | Origin | Mandatory |
| 6.2.4.1 | AirportCode | String | Airport code | Mandatory |
| 6.2.4.2 | AirportName | String | Airport name | Optional |
| 6.2.4.3 | Terminal | String | Terminal number | Optional |
| 6.2.4.4 | CityCode | String | City Code | Mandatory |
| 6.2.4.5 | CityName | String | city name | Mandatory |
| 6.2.4.6 | CountryCode | String | country code | Mandatory |
| 6.2.4.7 | CountryName | String | Country name | Mandatory |
| 6.2.5 | DepTime | Date Time | Departure time | Mandatory |
| 6.2.6 | Destination{} | Object | Destination | Mandatory |
| 6.2.6.1 | AirportCode | String | Airport code | Mandatory |
| 6.2.6.2 | AirportName | String | Airport name | Mandatory |
| 6.2.6.3 | Terminal | String | Terminal number | Optional |
| 6.2.6.4 | CityCode | String | City code | Mandatory |
| 6.2.6.5 | CityName | String | City name | Mandatory |
| 6.2.6.6 | CountryCode | String | Country code | Mandatory |
| 6.2.6.7 | CountryName | String | Country name | Mandatory |
| 6.2.7 | ArrTime | Date Time | Arrival time | Mandatory |
| 6.2.8 | Duration | Time | Duration (refer accumulated duration if the total durations is 0) | Optional |
| 6.2.9 | GroundTime | Time | Ground time | Optional |
| 6.2.10 | AccumulatedDuration | Time | Accumulated Duration | Optional |
| 6.2.11 | Mile | String | Miles | Optional |
| 6.2.12 | StopOver | String | Stop Over | Optional |
| 6.2.13 | StopPointArrivalTime | Date Time | Stopover arrival time | Optional |
| 6.2.14 | StopPointDepartureTime | Date Time | Stopover departure time | Optional |
| 6.2.15 | Craft | String | Craft | Optional |
| 6.2.16 | Remark | String | Remark | Optional |
| 6.2.17 | FlightStatus | String | Flight status | Mandatory |
| 6.2.18 | Status | String | Status | Mandatory |
| 6.2.19 | StopPoint | String | Stopover point | Optional |
| 6.3 | AirlineCode | String | Airline Code | Mandatory |
| 6.4 | ValidatingAirline | String | Validating Airline | Mandatory |
| 6.5 | OfferedFare | String | Decimal | Mandatory |