AirAvailabilitySearch

AirAvailabilitySearch

Availability seats request.

Request

• RequestedFlightInfo - contains information about the requested itinerary.
• RequestedFlightInfo.Direct - direct or connecting flights. Data type - bool.
• RequestedFlightInfo.ODPairs - container contains flight descriptions.
• ODPair.DepartureDateTime - date and time of the departure. Data type - string, format yyyy-mm-ddthh:mm:ss.
• ODPair.DeparturePoint - point of departure. Data type - string.
• DeparturePoint.Code - 3-letter code of the airport/city of departure. Data type - string.
• DeparturePoint.IsCity - attribute showing that the city code is used as the departure point. Data type - bool.
• ODPair.ArrivalPoint - point of arrival.
• ArrivalPoint.Code - 3-letter code of the airport/city of arrival. Data type - string
• ArrivalPoint.IsCity - attribute showing that the city code is used as the arrival point. Data type - bool.
• ODPair.FlightNumber - flight number. Data type - string.
• ODPair.BookingClassCode - flight class letter for this segment. Data type - string.
• Restrictions - additional search criteria (optional).
• Restrictions.CompanyFilter - filter by airline (mandatory).
• CompanyFilter.Company - filter by airline.
• Company.Code - 2-letter code of the airline (mandatory). Data type - string.
• Company.Include - filtration type (mandatory). Data type - bool.
• Company.SegmentNumber - number of the requested flight segment (numbering from 1 in this case), for which this airline is required. Data type - int.
• Restrictions.SourcePreference - list of preferred source (package).
• SourcePreference.Source - source identifier (package),for which a seat availability request will be sent. Data type - int.
• Restrictions.SeatsCount - seats number. Data type - int.

Example

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:avia="http://ws-ibe.com/Avia" xmlns:stl="http://ws-ibe.com/STL" xmlns:avia1="http://websky.travel/Avia">
   <soapenv:Header/>
   <soapenv:Body>
      <avia:AirAvailabilitySearch>
         <avia:Request>
            <stl:Requisites>
               <stl:AuthToken>token</stl:AuthToken>
               <stl:SupplierSessionId>sessionId</stl:SupplierSessionId>
            </stl:Requisites>
            <stl:UserID>11111</stl:UserID>
            <stl:RequestType>P</stl:RequestType>
            <stl:RequestBody>
               <avia1:RequestedFlightInfo>
                  <avia1:Direct>false</avia1:Direct>
                  <avia1:ODPairs>
                     <avia1:ODPair>
                        <avia1:DepartureDateTime>2024-12-23T00:00:00</avia1:DepartureDateTime>
                        <avia1:DeparturePoint>
                           <avia:Code>PAR</avia:Code>
                           <avia:IsCity>true</avia:IsCity>
                        </avia1:DeparturePoint>
                        <avia1:ArrivalPoint>
                           <avia:Code>BCN</avia:Code>
                           <avia:IsCity>true</avia:IsCity>
                        </avia1:ArrivalPoint>
                        <avia1:FlightNumber>2</avia1:FlightNumber>
                        <avia1:BookingClassCode>F</avia1:BookingClassCode>
                     </avia1:ODPair>
                  </avia1:ODPairs>
               </avia1:RequestedFlightInfo>
               <avia1:Restrictions>
                  <avia1:CompanyFilter>
                     <avia:Company>
                        <avia:Code>BA</avia:Code>
                        <avia:Include>true</avia:Include>
<!--                        <avia:SegmentNumber>1</avia:SegmentNumber>-->
                     </avia:Company>
                  </avia1:CompanyFilter>
                  <avia1:SourcePreference>
                     <avia:Source>-11111</avia:Source>
                  </avia1:SourcePreference>
                  <avia1:ClassPreference>
                     <avia:ClassOfService>Economy</avia:ClassOfService>
                  </avia1:ClassPreference>
                  <avia1:SeatsCount>9</avia1:SeatsCount>
               </avia1:Restrictions>
            </stl:RequestBody>
         </avia:Request>
      </avia:AirAvailabilitySearch>
   </soapenv:Body>
</soapenv:Envelope>

Response

The availability response message contains flight available seats by RBD for a city pair.

• OriginDestinationList - contains sets of flights for each cities pair.
• OriginDestinationList.OriginDestination - contains one or more (connecting) flights serving the cities pair.
• OriginDestination.DepartureCode - 3-letter airport/city code of departure. Data type - string.
• OriginDestination.ArrivalCode - 3-letter airport/city code of arrival. Data type - string.
• Flights.Flight - flight description.
• Flight.Segments - segment description.
• Segment.ID - segment identifier. Data type - int.
• Segment.DepAirp - description of departure point.
• DepAirp.AirportCode - 3-letter airport code of departure. Data type - string.
• DepAirp.CityCode - 3-letter city code of departure. Data type - string.
• DepAirp.UTC - time zone. Data type - string.
• DepAirp.Terminal - terminal. Data type - string.
• Segment.ArrAirp - description of arrival point.
• ArrAirp.AirportCode - 3-letter airport code of arrival. Data type - string.
• ArrAirp.CityCode - 3-letter city code of arrival. Data type - string.
• ArrAirp.UTC - time zone. Data type - string.
• ArrAirp.Terminal - terminal. Data type - string.
• Segment.FlightTime - flight time in minutes. Data type - string, format hh:mm.
• Segment.MarketingCarrierInfo - code of the airline that performs the sale of seats on this flight.
• MarketingCarrierInfo.Code - airline code. Data type - string.
• MarketingCarrierInfo.FlightNumber - flight number. Data type - string.
• Segment.OperatingCarrierInfo - airline code that carries passengers.
• OperatingCarrierInfo.Code - airline code. Data type - string.
• OperatingCarrierInfo.FlightNumber - flight number. Data type - string.
• Segment.AircraftType - type of aircraft. Data type - string.
• Segment.DepartureDateTime - date and time of departure. Data type - string, format yyyy-mm-ddthh:mm:ss.
• Segment.ArrivalDateTime - date and time of arrival. Data type - string, format yyyy-mm-ddthh:mm:ss.
• Segment.Avails - available seats on flight.
• Avails.RBD - information about availability seats per rbd.
• RBD.FreeSeatsCount - count of free seats. Data type - int.
• RBD.Value - booking class letter. Data type - string.

      <AirAvailabilitySearchResponse xmlns="http://ws-ibe.com/Avia">
         <AirAvailabilitySearchResult xmlns:a="http://ws-ibe.com/STL" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:RequestID>1150383685</a:RequestID>
            <a:ResponseBody xmlns:b="http://websky.travel/Avia">
               <b:OriginDestinationList>
                  <b:OriginDestination>
                     <b:DepartureCode>PAR</b:DepartureCode>
                     <b:ArrivalCode>BCN</b:ArrivalCode>
                     <b:Flights>
                        <b:Flight>
                           <b:Segments>
                              <b:Segment>
                                 <a:ID>0</a:ID>
                                 <DepAirp>
                                    <AirportCode>CDG</AirportCode>
                                    <CityCode>PAR</CityCode>
                                    <UTC>2</UTC>
                                    <Terminal>A</Terminal>
                                 </DepAirp>
                                 <ArrAirp>
                                    <AirportCode>BCN</AirportCode>
                                    <CityCode>BCN</CityCode>
                                    <UTC>3</UTC>
                                    <Terminal>2</Terminal>
                                 </ArrAirp>
                                 <b:FlightTime>01:15</b:FlightTime>
                                 <b:MarketingCarrierInfo>
                                    <b:Code>BA</b:Code>
                                    <b:FlightNumber>200</b:FlightNumber>
                                 </b:MarketingCarrierInfo>
                                 <b:OperatingCarrierInfo>
                                    <b:Code>BA</b:Code>
                                    <b:FlightNumber>200</b:FlightNumber>
                                 </b:OperatingCarrierInfo>
                                 <b:AircraftType>747</b:AircraftType>
                                 <b:DepartureDateTime>2022-01-17T10:00:00</b:DepartureDateTime>
                                 <b:ArrivalDateTime>2022-01-17T11:15:00</b:ArrivalDateTime>
                                 <b:Avails>
                                    <b:RBD>
                                       <b:FreeSeatsCount>12</b:FreeSeatsCount>
                                       <b:Value>C</b:Value>
                                    </b:RBD>
                                    <b:RBD>
                                       <b:FreeSeatsCount>12</b:FreeSeatsCount>
                                       <b:Value>D</b:Value>
                                    </b:RBD>
                                    <b:RBD>
                                       <b:FreeSeatsCount>450</b:FreeSeatsCount>
                                       <b:Value>Y</b:Value>
                                    </b:RBD>
                                    <b:RBD>
                                       <b:FreeSeatsCount>450</b:FreeSeatsCount>
                                       <b:Value>K</b:Value>
                                    </b:RBD>
                                    <b:RBD>
                                       <b:FreeSeatsCount>450</b:FreeSeatsCount>
                                       <b:Value>L</b:Value>
                                    </b:RBD>
                                    <b:RBD>
                                       <b:FreeSeatsCount>450</b:FreeSeatsCount>
                                       <b:Value>M</b:Value>
                                    </b:RBD>
                                    <b:RBD>
                                       <b:FreeSeatsCount>450</b:FreeSeatsCount>
                                       <b:Value>N</b:Value>
                                    </b:RBD>
                                    <b:RBD>
                                       <b:FreeSeatsCount>450</b:FreeSeatsCount>
                                       <b:Value>O</b:Value>
                                    </b:RBD>
                                 </b:Avails>
                              </b:Segment>
                           </b:Segments>
                        </b:Flight>
                     </b:Flights>
                  </b:OriginDestination>
               </b:OriginDestinationList>
            </a:ResponseBody>
         </AirAvailabilitySearchResult>
      </AirAvailabilitySearchResponse>