Flight Search V3
The Flight Search web service returns flight offers live from our travel partners. This service will help you bring travel to live on your site by providing your users with the opportunity to find available flights to an exhaustive list of destinations all over the world.
- Name: Flight Search
- Version: 3.0
- Path: /V3/flightsearch
- Schemas: flightsearch.xsd, common.xsd
- Markets: All markets
Request Parameters
The Flight Search web service supports the following request parameters:
| Name | Type | Summary |
|---|---|---|
| from | string (required) | The departure city. |
| to | string (required) | The destination city. |
| dep_day | integer (required) 1-31 |
The departure day. |
| dep_month | integer (required) 1-12 |
The departure month. |
| dep_year | integer (required) | The departure year. |
| ret_day | integer (optional) 1-31 |
The return day if applicable. |
| ret_month | integer (optional) 1-12 |
The return month if applicable. |
| ret_year | integer (optional) | The return year if applicable. |
| num_adults | integer (required) 1-5 |
The number of adults on this flight. |
| num_children | integer (required) 0-5 |
The number of children on this flight. |
| num_babies | integer (required) 0-2 |
The number of babies on this flight. |
| direct | string (optional) true or false |
The type of flight. It is set to “Direct=true” for direct flights only. |
| airline | string (optional) | The name of the airline. This parameter is only used in DK, NL and FR |
| ticketclass | string (required) economy or business |
The ticket class. |
| useAirportCode | bool (optional) true or false |
If set to true, the query will only use airports code. |
| sort | string (optional) | Sort the results by:
|
| results | integer (optional) | The number of results to return in each request |
| start | integer (optional) | The start index of the first result to return. |
| searchId | string (optional) | The search ID identifying the search. This is needed for paging |
Response elements
Top level Elements
| Name | Summary |
|---|---|
| FlightSearch | Root container for all API calls. Contains Journey elements. Including the xml schema and namespace definitions.Attributes:
|
Offer elements
- Common fields are used.
- Only the offer type FLIGHT_KELKOO can be contained in this service.
Sample Response
The following is a sample response when you search for a paris/london flight with the service.
<FlightSearch firstResultPosition="1" searchId="217146178142_1253190153149_60"> − <Offer type="FLIGHT_KELKOO" id="2375742021"> − <Url> http://uk.shoppingapis.kelkoo.com/ctl/go/shopbotGo?.ts=1254491259805&amp;amp;amp;amp;amp;.sig=IKwdMKWpy3A4WWeO06jiqYHk2Lw-&amp;amp;amp;amp;amp;catId=172201&amp;amp;amp;amp;amp;searchId=217146178169_1254491241397_106550&amp;amp;amp;amp;amp;tsSearchId=null&amp;amp;amp;amp;amp;merchantId=7943923&amp;amp;amp;amp;amp;pkey=0&amp;amp;amp;amp;amp;affiliationId=96925221&amp;amp;amp;amp;amp;country=uk&amp;amp;amp;amp;amp;offerId=2375742021&amp;amp;amp;amp;amp;nbchilds=0&amp;amp;amp;amp;amp;dday=10&amp;amp;amp;amp;amp;nbadults=1&amp;amp;amp;amp;amp;departure=London&amp;amp;amp;amp;amp;complementArrival=PARIS%2CPAR%2CFR&amp;amp;amp;amp;amp;from=shopbot&amp;amp;amp;amp;amp;type=Round%2FTrip&amp;amp;amp;amp;amp;ticketclass=economy&amp;amp;amp;amp;amp;dyear=2009&amp;amp;amp;amp;amp;dmonth=12&amp;amp;amp;amp;amp;rmonth=12&amp;amp;amp;amp;amp;nbbabies=0&amp;amp;amp;amp;amp;ryear=2009&amp;amp;amp;amp;amp;complementDeparture=LONDON%2CLON%2CUK&amp;amp;amp;amp;amp;arrival=Paris&amp;amp;amp;amp;amp;rday=20&amp;amp;amp;amp;amp;wait=true&amp;amp;amp;amp;amp;ecs=ok </Url> − <Merchant id="7943923"> <Name>Bravofly</Name> </Merchant> − <Category id="172201"> <Name>Flights</Name> </Category> − <Price currency="EUR"> <Price>46.19</Price> </Price> − <Flight> <Date>2009-12-10+01:00</Date> − <Time> <Departure>08:10 morning</Departure> <Arrival>10:30 morning,noon</Arrival> </Time> <Duration>02:20</Duration> <From>LTN</From> <To>CDG</To> − <AirportDeparture> <AirportCode>Ltn</AirportCode> <AirportName>Ltn</AirportName> </AirportDeparture> − <AirportArrival> <AirportCode>Cdg</AirportCode> <AirportName>Cdg</AirportName> </AirportArrival> <FlightList>U22435</FlightList> </Flight> − <Flight> <Date>2009-12-20+01:00</Date> − <Time> <Departure>18:25 evening</Departure> <Arrival>18:40 evening</Arrival> </Time> <Duration>00:15</Duration> <From>CDG</From> <To>LTN</To> − <AirportDeparture> <AirportCode>Ltn</AirportCode> <AirportName>Ltn</AirportName> </AirportDeparture> − <AirportArrival> <AirportCode>Cdg</AirportCode> <AirportName>Cdg</AirportName> </AirportArrival> <FlightList>U22440</FlightList> </Flight> <TicketClass>economy</TicketClass> <NbAdults>1</NbAdults> <NbChildren>0</NbChildren> <NbBabies>0</NbBabies> </Offer> </FlightSearch>