Flight API · Search & pricing
FlightDetail
The FlightDetail request is submitted when the end-user selects a specific flight. The FlightDetail request is used to get information related to the selected flight, rules and price.
Please note that you have 8 minutes to confirm your booking request after getting the response.
Request
Case of GDS Flight
<FlightDetailRQ>
<Credentials>
<Login>?</Login>
<Password>?</Password>
</Credentials>
<User>?</User>
<OfficeId>?</OfficeId>
<SFM>?</SFM>
<Ilng>?</Ilng>
<Curr>?</Curr>
<Content>gds</Content>
<CarrierCode>?</CarrierCode>
<Passenger>
<Adult>?</Adult>
<Child>?</Child>
<Infant>?</Infant>
</Passenger>
<Flight>
<Luggage>?</Luggage>
<Origin>?</Origin>
<Destination>?</Destination>
<Itineraries>
<Itinerary>
<Ref>?</Ref>
<Segments>
<Segment>
<Departure>?</Departure>
<Arrival>?</Arrival>
<DepartureDate>?</DepartureDate>
<Company>?</Company>
<FlightNumber>?</FlightNumber>
<Cabin>?</Cabin>
<BookingClass>?</BookingClass>
</Segment>
</Segments>
</Itinerary>
</Itineraries>
</Flight>
</FlightDetailRQ>| Root | Sub root | Tag | Description | Values & Format |
|---|---|---|---|---|
| Credentials | Mandatory | |||
| Login | Mandatory | |||
| Password | Mandatory | |||
| User | Mandatory | |||
| Curr | Optional | 3 alphanumeric character for each currency, you can send more than one currency separate by semicolon | 1-get price in one currency <Curr>EUR</Curr> 2-get price in multiples currencies <Curr>EUR;TND</Curr> | |
| SFM | Optional | Numeric value | Contains Amadeus service fees,, Only for GDS | |
| OfficeId | Optional | Is the OfficeId received in FlightStartSearchRS | If you don’t specify the officeId, we use the first one in DB Only for GDS | |
| Ilng | Mandatory | Numeric value | Default value 2 (English) | |
| CarrierCode | Mandatory | 2 characters : gds case | ||
| Passenger | Mandatory | This parameter is designed to specify the number of seats required for the travelling passengers of flights | Maximum 9 passengers | |
| Adult | Mandatory | Numeric value | At least one adult must be specified | |
| Child | Mandatory | Numeric value | It can be 0 or plus | |
| Infant | Mandatory | Numeric value | It can be 0 or plus | |
| Flight | Mandatory | Numeric value | ||
| Origin | Mandatory | The start location code (airport) | ||
| Destination | Mandatory | The end location code (airport) | ||
| Itineraries: Itinerary: | Mandatory | Itinerary details | ||
| Ref | Mandatory | Rank of itinerary for the flight 1: outward and 2: return | Incremental value, if Ref 1 only then flight is one-way, if Ref 1 and Ref 2 then round-trip | |
| Segments: Segment | Mandatory | Each itinerary can be composed by one or more segments | ||
| Departure | Mandatory | The user must specify a departure location (code of airport) | ||
| Arrival | Mandatory | The user must specify an arrival location (code of airport) | ||
| DepartureDate | Mandatory | The date of departure that will be requested | ||
| Company | Mandatory | Airline company code | ||
| FlightNumber | Mandatory | The flight number of a segment | ||
| BookingClass | Mandatory | The booking class of a requested segment | ||
| Cabin | Mandatory | The cabin of a requested segment | ||
| Luggage | Optional | The User has the ability to request flight with bags | True : filter flights with bags |
Case of LCC Flight
<FlightDetailRQ>
<Credentials>
<Login>Cu2gOrbzhN0=</Login>
<Password>mtPXhFzrzuM=</Password>
</Credentials>
<User>707</User>
<Ilng>1</Ilng>
<Curr>EUR</Curr>
<CarrierCode>V14EVYBWRB1EY35S</CarrierCode>
<OutwardCode>W7OVV4JSZHGTGEQK</OutwardCode>
<Content>lcc</Content>
<Passenger>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
</Passenger>
</FlightDetailRQ>| Root | Sub root | Tag | Description | Values & Format |
|---|---|---|---|---|
| Credentials | Mandatory | |||
| Login | Mandatory | |||
| Password | Mandatory | |||
| User | Mandatory | |||
| Curr | Optional | 3 alphanumeric character | ||
| Ilng | Mandatory | Numeric value | Default value 2 (English) | |
| CarrierCode | Mandatory | 16 characters : lcc case | ||
| OutwardCode | Mandatory | The Id of an outward leg, much carrier code of first itinerary. | ||
| ReturnCode | Optional | The Id of a return leg, much carrier code of second itinerary. | ||
| Passenger | Mandatory | This parameter is designed to specify the number of seats required for the travelling passengers of flights | Maximum 9 passengers | |
| Adult | Mandatory | Numeric value | At least one adult must be specified | |
| Child | Mandatory | Numeric value | It can be 0 or plus | |
| Infant | Mandatory | Numeric value | It can be 0 or plus |
Response
Case of GDS Flight
<FlightDetailRS>
<User>707</User>
<Ilng>1</Ilng>
<Session>213</Session>
<OfficeId>OOOO01</OfficeId>
<Parameters>
<Parameter>
<Name>PassportNumber</Name>
<PerPassenger>true</PerPassenger>
</Parameter>
<Parameter>
<Name>PassportExpiryDate</Name>
<PerPassenger>true</PerPassenger>
</Parameter>
<Parameter>
<Name>DateOfBirth</Name>
<PerPassenger>true</PerPassenger>
</Parameter>
<Parameter>
<Name>Nationality</Name>
<PerPassenger>true</PerPassenger>
</Parameter>
</Parameters>
<Itineraries>
<Itinerary>
<Company title= "Air France">AF</Company>
<FlightNumber>2184</FlightNumber>
<Duration>02h30m</Duration>
<DepartureDate>01/10/2012 07:35</DepartureDate>
<OriginTerminal>2F</OriginTerminal>
<Origin title= "France - Charles de Gaulle(CDG)">CDG</Origin>
<ArriveDate>01/10/2012 09:05</ArriveDate>
<DestinationTerminal>M</DestinationTerminal>
<Destination title= "Tunisia - Carthage Airport(TUN)">TUN</Destination>
<Equipment>319</Equipment>
<Cabin title="Standard economic">M</Cabin>
<BookingClass>M</ BookingClass >
<FreeAllowance>1</FreeAllowance>
<QuantityCode>N</QuantityCode>
</Itinerary>
</Itineraries>
<Price>
<Amount>1153.35</Amount>
<Tax>100.20</Tax>
<Currency>EUR</Currency>
<Fees>0</Fees>
<PricingGroup>
<Group>
<Kind>ADT</Kind>
<Pax>1</Pax>
<HT>1053.15</HT>
<Tax>100.20</Tax>
<Fees>0</Fees>
<Total>1153.35</Total>
<Currency>EUR</Currency>
</Group>
</PricingGroup>
</Price>
<Rules>
<Rule title="RU.RULE APPLICATION">
<FreeText> NORMAL FLEX FARES WITHIN EUROPE</FreeText>
<FreeText> APPLICATION</FreeText>
<FreeText> AREA</FreeText>
<FreeText> THESE FARES APPLY</FreeText>
<FreeText> WITHIN EUROPE.</FreeText>
<FreeText> CLASS OF SERVICE</FreeText>
<FreeText> THESE FARES APPLY FOR FIRST/BUSINESS/ECONOMY CLASS</FreeText>
<FreeText> SERVICE.</FreeText>
<FreeText> TYPES OF TRANSPORTATION</FreeText>
<FreeText> THIS RULE GOVERNS ONE WAY AND ROUND TRIP FARES.</FreeText>
<FreeText> FARES GOVERNED BY THIS RULE CAN BE USED TO CREATE ONE</FreeText>
<FreeText> WAY/ROUND TRIP/CIRCLE TRIP/OPEN JAW JOURNEYS.</FreeText>
<FreeText> OTHER CONDITIONS</FreeText>
<FreeText> PASSENGER EXPENSES -</FreeText>
<FreeText> PERMITTED.</FreeText>
<FreeText> FARES SHALL BE ESTABLISHED AND AMENDED BY IATA.</FreeText>
</Rule>
<Rule title="MX.MAX STAY">
<FreeText> NONE UNLESS OTHERWISE SPECIFIED</FreeText>
</Rule>
<Rule title="SR.SALES RESTRICT">
<FreeText>BETWEEN TC2 - EUROPE (INCLUDES ZONES 211 AND 212) AND TC2 -</FreeText>
<FreeText> EUROPE (INCLUDES ZONES 211 AND 212)</FreeText>
<FreeText> TICKETS MUST BE ISSUED ON/AFTER 01OCT2011.</FreeText>
<FreeText> *** GENERAL RULE FOLLOWS ***</FreeText>
<FreeText> NOTE -</FreeText>
<FreeText> ADVERTISING AND SALES - NO RESTRICTIONS.</FreeText>
<FreeText> SALES -</FreeText>
<FreeText> SHALL INCLUDE THE ISSUANCE OF TICKETS AND</FreeText>
<FreeText> MISCELLANEOUS CHARGES ORDERS -MCO- / MULTIPLE</FreeText>
<FreeText> PURPOSE DOCUMENTS -MPDS- AND PREPAID TICKET</FreeText>
<FreeText> ADVICES -PTAS-.</FreeText>
<FreeText> ADVERTISING -</FreeText>
<FreeText> ANY LIMITATIONS ON ADVERTISING SHALL NOT</FreeText>
<FreeText> PRECLUDE THE QUOTING OF SUCH FARES IN COMPANY</FreeText>
<FreeText> TARIFFS AND SYSTEM TIMETABLES AND AIR GUIDES.</FreeText>
<FreeText> EXTENSION OF VALIDITY -</FreeText>
<FreeText> A CARRIER MAY WITHOUT ADDITIONAL COLLECTION OF</FreeText>
<FreeText> FARE EXTEND THE VALIDITY OF THE TICKET OF A</FreeText>
<FreeText> PASSENGER WHO IS PREVENTED FROM TRAVELLING</FreeText>
<FreeText> WITHIN THE PERIOD OF VALIDITY OF HIS TICKET.</FreeText>
</Rule>
<Rule title="TR.TVL RESTRICTION">
<FreeText>BETWEEN TC2 - EUROPE (INCLUDES ZONES 211 AND 212) AND TC2 -</FreeText>
<FreeText> EUROPE (INCLUDES ZONES 211 AND 212)</FreeText>
<FreeText> VALID FOR TRAVEL COMMENCING ON/AFTER 01OCT2011.</FreeText>
</Rule>
<Rule title="CD.CHILD DISCOUNTS">
<FreeText>FOR YIF TYPE FARES</FreeText>
<FreeText>NOTE - GENERAL RULE DOES NOT APPLY.</FreeText>
<FreeText> AN ACCOMPANIED CHILD 2-11 YEARS OF AGE - CHARGE 75</FreeText>
<FreeText> PERCENT OF THE FARE.</FreeText>
<FreeText> TICKET DESIGNATOR- CH AND PERCENT OF DISCOUNT</FreeText>
<FreeText> MUST BE ACCOMPANIED ON ALL FLIGHTS BY ADULT 12 OR</FreeText>
<FreeText> OLDER.</FreeText>
<FreeText> OR - AN UNACCOMPANIED CHILD 2-11 YEARS OF AGE - CHARGE</FreeText>
<FreeText> 100 PERCENT OF THE FARE.</FreeText>
<FreeText> TICKET DESIGNATOR- CH AND PERCENT OF DISCOUNT</FreeText>
<FreeText> OR - 1ST INFANT UNDER 2 YEARS OF AGE AND NOT OCCUPYING A</FreeText>
<FreeText> SEAT - CHARGE 10 PERCENT OF THE FARE.</FreeText>
<FreeText> TICKET DESIGNATOR- IN AND PERCENT OF DISCOUNT</FreeText>
<FreeText> MUST BE ACCOMPANIED ON ALL FLIGHTS BY ADULT 12 OR</FreeText>
<FreeText> OLDER.</FreeText>
<FreeText> OR - AN INFANT UNDER 2 YEARS OF AGE AND OCCUPYING A SEAT</FreeText>
<FreeText> - CHARGE 75 PERCENT OF THE FARE.</FreeText>
<FreeText> TICKET DESIGNATOR- CH AND PERCENT OF DISCOUNT</FreeText>
<FreeText> MUST BE ACCOMPANIED ON ALL FLIGHTS BY ADULT 12 OR</FreeText>
<FreeText> OLDER.</FreeText>
</Rule>
<Rule title="TC.TOUR CONDUCTOR">
<FreeText> NONE UNLESS OTHERWISE SPECIFIED</FreeText>
</Rule>
<Rule title="AD.AGTS DISCOUNTS">
<FreeText>FOR ECONOMY UNRESTRICTED FARES</FreeText>
<FreeText> NOTE -</FreeText>
<FreeText> PERMITTED.</FreeText>
</Rule>
<Rule title="SO.STOPOVERS">
<FreeText>FOR ECONOMY UNRESTRICTED FARES</FreeText>
<FreeText> UNLIMITED STOPOVERS PERMITTED.</FreeText>
</Rule>
<Rule title="EL.ELIGIBILITY">
<FreeText> NOTE -</FreeText>
<FreeText> UNACCOMPANIED INFANT - NOT ELIGIBLE.</FreeText>
</Rule>
<Rule title="CO.COMBINABILITY">
<FreeText> FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS WITH</FreeText>
<FreeText> ANY FARE FOR ANY CARRIER IN ANY RULE AND TARIFF TO FORM</FreeText>
<FreeText> ROUND TRIPS/CIRCLE TRIPS.</FreeText>
<FreeText> ADD-ONS PERMITTED.</FreeText>
<FreeText> END-ON-END</FreeText>
<FreeText> END-ON-END COMBINATIONS PERMITTED. VALIDATE ALL FARE</FreeText>
<FreeText> COMPONENTS.</FreeText>
<FreeText> NOTE -</FreeText>
<FreeText> SIDE TRIP COMBINATIONS PERMITTED.</FreeText>
<FreeText> IN THE CASE OF SIDE TRIPS SUCH SIDE TRIPS ARE</FreeText>
<FreeText> ONLY PERMITTED FROM AND TO THE SAME ENROUTE</FreeText>
<FreeText> POINT OF A FARE COMPONENT.</FreeText>
<FreeText> OPEN JAWS</FreeText>
<FreeText> FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS</FreeText>
<FreeText> -TO FORM SINGLE OR DOUBLE OPEN JAWS THAT CONSIST OF NO</FreeText>
<FreeText> MORE THAN 2 INTERNATIONAL FARE COMPONENTS. ORIGIN OPEN</FreeText>
<FreeText> SEGMENT MUST BE WITHIN ONE COUNTRY.</FreeText>
<FreeText> A MAXIMUM OF 2 INTERNATIONAL FARE COMPONENTS PERMITTED</FreeText>
<FreeText> PROVIDED -</FreeText>
<FreeText> WHEN THE OPEN JAW OCCURS AS FOLLOWS -</FreeText>
<FreeText> THE OPEN SEGMENT MUST BE</FreeText>
<FreeText> -BETWEEN AREA 2 AND AREA 3/BETWEEN AREA 2 AND AREA 1 OR</FreeText>
<FreeText> WITHIN AREA 2-</FreeText>
<FreeText> COMBINATIONS ARE WITH ANY FARE FOR ANY CARRIER IN ANY</FreeText>
<FreeText> RULE IN ANY TARIFF.</FreeText>
</Rule>
</Rules>
</FlightDetailRS>Case of LCC Flight
<FlightDetailRS>
<User>707</User>
<Ilng>1</Ilng>
<Parameters>
<Parameter>
<Name>PassportNumber</Name>
<PerPassenger>true</PerPassenger>
</Parameter>
<Parameter>
<Name>PassportExpiryDate</Name>
<PerPassenger>true</PerPassenger>
</Parameter>
<Parameter>
<Name>DateOfBirth</Name>
<PerPassenger>true</PerPassenger>
</Parameter>
<Parameter>
<Name>Nationality</Name>
<PerPassenger>true</PerPassenger>
</Parameter>
</Parameters>
<BaggageRestriction>
<Numbers>
<Number value="1">1</Number>
<Number value="2">2</Number>
</Numbers>
<Weights>
<Weight value="0">15</Weight>
<Weight value="1">20</Weight>
<Weight value="2">25</Weight>
<Weight value="3">30</Weight>
</Weights>
<Fees>
<Fee>
<Quantity>5</Quantity>
<Weight>50</Weight>
<MaxWeight>50</MaxWeight>
<Amount>245.00</Amount>
<Currency>EUR</Currency>
</Fee>
</Fees>
</BaggageRestriction>
<Itineraries>
<OutwardDuration>2h30m</OutwardDuration>
<Itinerary>
<Company title="Transavia France">Transavia France</Company>
<FlightNumber>TO3222</FlightNumber>
<DepartureDate>01/10/2012-06:00</DepartureDate>
<ArriveDate>01/10/2012-07:30</ArriveDate>
<Cabin>Economy With Restrictions</Cabin>
<Origin title="France - Orly(ORY)">ORY</Origin>
<Destination title="Tunisia - Carthage Airport(TUN)">TUN</Destination>
</Itinerary>
</Itineraries>
<Price>
<Amount>131.75</Amount>
<Tax>43.90</Tax>
<Currency>EUR</Currency>
<Fees>0</Fees>
</Price>
<Rules>
<Rule title="FareRulesInfo-Outward" type="text">This ia a one way fare For any changes fees will apply FLIGHT AND OR DATE CHANGES: To the same bookingsclass at a charge of EUR 40. To a different bookingsclass at a charge of EUR 40. plus fare differential PERSON CHANGES: To the same bookingsclass
at a charge of EUR 40. To a different bookingsclass at a charge of EUR 40. plus fare differential NAME CHANGES DUE MISSPELLING: (EG. JANSEN JANSSEN) A charge of EUR 40. INFANT FEE: At a charge of EUR 15. per segment CANCELLATIONS Cancellations
can only be made over the phone through the transavia.com call center. cancellation costs amount to 100% of the total booking fee. No refund is given therefore, with the exception of passenger taxes imposed by the airport or authorities, which
can be refunded at passengers request. A request for refund of these taxes must be made in writing within 3 months of the booked travel date. Send the request to transavia.com Attn Customer Relations (tax refund), P.O. box 7777, 1118 ZM Schiphol,
The Netherlands Stating reservation number,passenger names and travel dates. Only if this information is given, we can process this request. Requests for refund are subject to a charge of \'80 30 administration costs per cancelled booking.
Updated: BRG/07OCT10 </Rule>
<Rule title="" type="link">http://www.transavia.com/hv/en-EU/conditionsHV</Rule>
<Rule title="" type="link">http://service-en.transavia.com/app/answers/list/p/12</Rule>
<Rule title="" type="link">http://www.transavia.com/hv/main/service?id=bagage_meenemen</Rule>
<Rule title="" type="link">http://www.transavia.com/hv/main/service?id=tarieven_ruimbagage_boeking_site_callcenter&lang=en&country=EU</Rule>
<Rule title="" type="link">http://www.transavia.com/hv/en-EU/disclaimer</Rule>
<Rule title="Length the of postcode" type="text">Please note that the length of postcode must not be greater than 10 characters.</Rule>
<Rule title="General Fare Rule" type="text">Please note, fares are not guaranteed until you purchase your ticket, so it might be changed in the next stage, and keep in mind that the total fare in next step is the right final amount to pay.</Rule>
<Rule title="Per baggage wieght role" type="text">Each weight of luggage has a limit of 32kg/piece of luggage per passenger/segment.</Rule>
<Rule title="Baggage charge changed" type="text">20 hold luggage has been no longer included in the ticket since April 4th and you have to call the call center or go online to book this service if you need it.</Rule>
<Rule title="Per baggage wieght maximum" type="text">Total weight of luggage may not exceed 50kg per passenger/segment.</Rule>
<Rule title="Per baggage number maximum" type="text">Maximum of luggage can be 5 pieces only.</Rule>
</Rules>
</FlightDetailRS>| Root | Sub root | Description |
|---|---|---|
| User | ||
| Ilng | Numeric value | |
| Session | Reference of the current transaction | |
| OfficeId | OfficeId to be used for API FlightBookingCreationRQ, only for GDS | |
| Parameters | The HTTP query parameters. These parameters should be used to build an HTML form. This form must be submitted by the user's browser to transfer the user to the supplier's site to complete the booking. This element will be omitted if there are no parameters to be submitted or they are all contained in the URL. | |
| Parameters:Parameter -----Name -----PerPassenger List of main Parameter “GDS” 1.PassportNumber : Type Text (Optional) 2.PassportExpiryDate : Type Date (Optional) 3.FrequentFlyerNumber : Type Text (Optional) 4. DateOfBirth : Type Date (Optional) 5.Nationality : Type List of country iso code (Optional) 6. NationalIDCard : Text (Optional) 7. PassengerEmail : Type Text (Mandatory for the main passenger) 8. PassengerTelephone : Type Text (Mandatory for the main passenger) “LCC” 1.PassportNumber : Type Text (Mandatory) 2.PassportExpiryDate : Type Date (Mandatory) 3. DateOfBirth : Type Date (Mandatory) 4.Nationality : Type List of country iso code (Mandatory) | An http parameter. This corresponds to an 'input' within the HTML form. The parameter name. This corresponds to an 'input' name within the HTML form. The parameter perpassenger used to display inputs per passenger or per booking. These parameters will be used in FlightBookingCreation API under node traveller | |
| BaggageRestriction | Contains the list of the restrictions of baggage feature. If this tag is omitted means the supplier doesn’t support baggage features. | |
| --Numbers --Weights | Contains the list of numbers/weights for this specific baggage service of the supplier. | |
| ----Number ----Weight | Represents an item (number or weight) with specific value. You must use value in API requests and the tag value for your final uses. | |
| Itineraries | ||
| Itinerary | ||
| Itinerary:Company | The code company of an itinerary. | |
| Itinerary:FlightNumber | The flight number of an itinerary. | |
| Itinerary:Duration | The duration of an itinerary. Format is hhmm (hh: hour, mm: minutes). | |
| Itinerary:DepartureDate | The date of departure. | |
| Itinerary:OriginTerminal | The terminal of departure. | |
| Itinerary:Origin | The code airport of departure. | |
| Itinerary:ArriveDate | The date of arrival. | |
| Itinerary:DestinationTerminal | The terminal of arrival. | |
| Itinerary:Destination | The code airport of arrival. | |
| Itinerary:Equipment | The code of equipment type. | |
| Itinerary:Cabin | The class of an itinerary. | |
| Itinerary: | The bookingclass of an itinerary. | |
| Itinerary:FreeAllowance | This node serves to check the quantity of authorized luggage. | |
| Itinerary:QuantityCode | This node serves to check the qualifier of luggage quantity . Qualifier Code 700 : Kg 701 : pounds 702 : nil C : special Charge N : piece(s) S : size V : value W : weight | |
| Price | you get | |
| Amount | The total amount. | |
| Tax | The total tax. | |
| Currency | The code currency of the current price. | |
| Rules | ||
| Rule:title | The title of the rule. | |
| Rule:FreeText | The description of the rule. | |
| Rule:type | The type of content |