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 End User | Mandatory |
| 2 | ClientId | String | Client ID provided to the agency at registration | Mandatory |
| 3 | UserName | String | Username provided to the agency at registration | Mandatory |
| 4 | Password | String | Password provided to the agency at registration | Mandatory |
| 5 | AdultCount | Integer | Number of adults (Minimum value should be 1) | Mandatory |
| 6 | ChildCount | Integer | Number of children (Minimum value should be 0) | Mandatory |
| 7 | InfantCount | Integer | Number of infants (Minimum value should be 0) | Mandatory |
| 8 | JourneyType | Integer | 1 - OneWay, 2 – Return, 3 – Multi City | Mandatory |
| 9 | DirectFlight | Boolean | If it is TRUE only direct flight will come. (Value – True or False) | Optional |
| 10 | SoftwareType | Enumeration | B2B or B2C | Optional |
| 11 | FareType | String | Possible values : 1 - Normal Fare, 2 - Student Fare, 3 - SeniorCitizen Fare, 4 - ArmedForce Fare | Optional |
| 12 | Sources | String | Airline Sources : 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 segments | Mandatory |
| 13.1 | Origin | String | Origin city code | Mandatory |
| 13.2 | Destination | String | Destination city code | Mandatory |
| 13.3 | FlightCabinClass | Integer | Cabin Class : 1 - All, 2 - Economy, 3 - PremiumEconomy, 4 - Business, 5 - PremiumBusiness, 6 - First Class | Mandatory |
| 13.4 | PreferredDepartureTime | Date Time | Preferred departure date time 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 arrival date time 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 | Error | Mandatory |
| 1.1 | ErrorCode | String | ErrorCode | Mandatory |
| 1.2 | ErrorMessage | String | Error Message | Mandatory |
| 2 | TraceId | Integer | Trace ID | 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 | Array of flight results ( 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 | Buton Color | Mandatory |
| 6.1.6 | TextColor | String | Text Color | Mandatory |
| 6.1.7 | IsLCC | Boolean | Is the result for LCC or Non LCC (Value – True or False) | Mandatory |
| 6.1.8 | IsRefundable | Boolean | Is the fare refundable (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 |