ScheduleSearch

ScheduleSearch

Search by the schedule.

Request

Format Description
  • RequestedFlightInfo - contains information about the flight segments you want to find. Data type - array.
  • RequestedFlightInfo.Direct - indicator of search of only direct flights. Data type - bool.
  • RequestedFlightInfo.ODPair - segment of the flight you want to find. Data type - array.
  • RequestedFlightInfo.ODPair.DepatureDateTime - departure date or period start date and time (optional), from which the desired departure time begins. Data type - string, the format is yyyy-mm-dd[thh:mm:ss].
  • RequestedFlightInfo.ODPair.DepatureDateTime2 - end date of the period. Data type - string, the format is yyyy-mm-dd.
  • RequestedFlightInfo.ODPair.MaxDepatureTime - maximum-allowed departure time. Data type - string, the format is hh:mm.
  • RequestedFlightInfo.ODPair.DepaturePoint - contains information about the origin point. Data type - array.
  • RequestedFlightInfo.ODPair.DepaturePoint.Code - 3 letter code of the airport/city of departure. Data type - string.
  • RequestedFlightInfo.ODPair.DepaturePoint.IsCity - attribute showing that code of the city, which is the airport aggregator, is indicated as the departure point. Data type - bool.
  • RequestedFlightInfo.ODPair.ArrivalPoint - contains information about the arrival point. Data type - array. The format is similar to the DepaturePoint element.
  • Restrictions - similar to the Restrictions parameter from the Search_1_2 (optional).
  • Restrictions.CompanyFilter - array of airline filters. Data type - array.
  • Restrictions.CompanyFilter.Company - information about airline filtering. Data type - array.
  • Restrictions.CompanyFilter.Company.Code - 2-letter airline code which triggers the filter criteria. Data type - string.
  • Restrictions.CompanyFilter.Company.Include - filtering type. Data type - bool. If false is indicated, the specified airline will be excluded from the search results; if true is indicated - only this airline will be present in the search results, except the other airline specified in filter parameters with the true parameter.
  • Restrictions.CompanyFilter.Company.SegmentNumber - number of the requested flight segment (numbering from 1 in this case), for which this airline is required. Data type - 32-bit integer. Available only for Amadeus, Travelport uAPI, Sabre.
  • EndUserData - end user data. Data type - array, the format is similar to the EndUserData element from the DataItem (optional).
Sample
<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:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://websky-ibe.com/STL" xmlns:ns2="http://websky-ibe.com/Avia">
   <soapenv:Header/>
   <soapenv:Body>
      <avia:ScheduleSearch>
         <avia:Request>
            <stl:Requisites>
               <stl:AuthToken>token</stl:AuthToken>
            </stl:Requisites>
            <stl:UserID>11111</stl:UserID>
            <stl:RequestType>P</stl:RequestType>
            <stl:RequestBody>
               <avia:RequestedFlightInfo>
                  <avia:Direct>false</avia:Direct>
                  <avia:ODPair>
                     <avia:DepatureDateTime>2025-01-01</avia:DepatureDateTime>
                     <avia:DepaturePoint>
                        <avia:Code>PAR</avia:Code>
                        <avia:IsCity>true</avia:IsCity>
                     </avia:DepaturePoint>
                     <avia:ArrivalPoint>
                        <avia:Code>BCN</avia:Code>
                        <avia:IsCity>true</avia:IsCity>
                     </avia:ArrivalPoint>
                     <avia:DepatureDateTime2>2025-01-10</avia:DepatureDateTime2>
                  </avia:ODPair>
               </avia:RequestedFlightInfo>
               <avia:Restrictions>
                  <avia:CompanyFilter>
                     <avia:Company>
                        <avia:Code>AY</avia:Code>
                        <avia:Include>true</avia:Include>
                     </avia:Company>
                  </avia:CompanyFilter>
                  <avia:ClassPreference>
                     <avia:ClassOfService>Economy</avia:ClassOfService>
                  </avia:ClassPreference>
                  <avia:ResultsGrouping>None</avia:ResultsGrouping>
                  <avia:SourcePreference>
                     <avia:Source>-10000</avia:Source>
                  </avia:SourcePreference>
               </avia:Restrictions>
            </stl:RequestBody>
         </avia:Request>
      </avia:ScheduleSearch>
   </soapenv:Body>
</soapenv:Envelope>

Response

  • Flights - container for the search results. Data type - array.
  • Flights.ScheduleFlight - found flight in the schedule. Data type - array. The format is similar to the Flight element from the Search_1_2, but instead of the Segments property, the ScheduleSegments property, described below, is used.
  • ScheduleFlight.ScheduleSegments - array of ScheduleSegment elements. Data type - array.
  • ScheduleSegment - information about the flight segment. Data type - array.
  • ScheduleSegment.ID - sequence number of this segment of the flight. Data type - 32-bit integer.
  • ScheduleSegment.DepAirp - information about the departure airport for this segment. Data type - array.
  • ScheduleSegment.DepAirp.AirportCode - airport code. Data type - string.
  • ScheduleSegment.DepAirp.CityCode - city code (aggregation code). Data type - string.
  • ScheduleSegment.DepAirp.UTC - airport timezone. Data type - string.
  • ScheduleSegment.DepAirp.Terminal - terminal code. Data type - string.
  • ScheduleSegment.ArrAirp - arrival airport information for this segment. Data type - array. The format is similar to the departure airport.
  • ScheduleSegment.ETicket - attribute of the possibility of issuing an e-ticket on this segment. Data type - bool.
  • ScheduleSegment.StopPoints - list of stop points on this segment of the flight. Data type - array.
  • ScheduleSegment.StopPoints.StopPoint - information about one of the stop points on this segment of the flight. Data type - array.
  • ScheduleSegment.StopPoints.StopPoint.AirportCode - stop point airport code. Data type - string.
  • ScheduleSegment.StopPoints.StopPoint.CityCode - stop point city code. Data type - string.
  • ScheduleSegment.StopPoints.StopPoint.UTC - time zone of the stop point. Data type - string.
  • ScheduleSegment.StopPoints.StopPoint.Terminal - terminal at the airport. Data type - string.
  • ScheduleSegment.StopPoints.StopPoint.ArrDateTime - date and time of arrival at the stop point in the format yyyy-mm-ddthh:mm:ss. Data type - string.
  • ScheduleSegment.StopPoints.StopPoint.DepDateTime - date and time of departure from the stop point in the format yyyy-mm-ddthh:mm:ss. Data type - string.
  • ScheduleSegment.FlightNumber - flight number for this flight segment. Data type - 32-bit integer.
  • ScheduleSegment.FlightTime - flight time in minutes. Data type - 32-bit integer.
  • ScheduleSegment.OpAirline - code of the airline directly executing this flight. Data type - string.
  • ScheduleSegment.MarkAirline - airline code for the given flight. Data type - string.
  • ScheduleSegment.AircraftType - aircraft type code. Data type - string.
  • ScheduleSegment.DepartueTime - departure time in hh:mm format. Data type - string.
  • ScheduleSegment.ArrivalTime - arrival time in hh:mm format. Data type - string.
  • ScheduleSegment.DepartureDaysChange - shift of the departure day relative to the departure date of the first segment of the entire flight. Data type - 32-bit integer.
  • ScheduleSegment.ArrivalDaysChange - shift of the day of arrival relative to the departure day. Data type - 32-bit integer.
  • ScheduleSegment.StartDate - start date of the departure period in the format yyyy-mm-dd. Data type - string.
  • ScheduleSegment.EndDate - end date of the departure period in the format yyyy-mm-dd. Data type - string.
  • ScheduleSegment.OperatedDaysOfWeek - array of departure days. Data type - array.
  • ScheduleSegment.OperatedDaysOfWeek.DayOfWeek - day of the week in which the flight will take place. Data type - enumeration, possible values:
    • Monday
    • Tuesday
    • Wednesday
    • Thursday
    • Friday
    • Saturday
    • Sunday
  • ScheduleSegment.BaseClasses - array with available base flight classes. Data type - array.
  • ScheduleSegment.BaseClasses.BaseClass - base flight class. Data type - enumeration. Possible values:
    • Economy - Economy class (both standard and premium).
    • Business - Business class (both standard and premium).
    • First - First class (both standard and premium).
    • Other - All other classes that do not belong to any of the above.
Sample
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ScheduleSearchResponse xmlns="http://ws-ibe.com/Avia">
         <ScheduleSearchResult xmlns:a="http://ws-ibe.com/STL" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:RequestID>10000656576</a:RequestID>
            <a:ResponseBody>
               <Flights>
                  <ScheduleFlight>
                     <a:ID i:nil="true"/>
                     <SourceID>-10000</SourceID>
                     <TypeInfo i:nil="true"/>
                     <MandatoryLatinNames>false</MandatoryLatinNames>
                     <ScheduleSegments>
                        <ScheduleSegment>
                           <a:ID>1</a:ID>
                           <DepAirp>
                              <AirportCode>CDG</AirportCode>
                              <Terminal>2F</Terminal>
                           </DepAirp>
                           <ArrAirp>
                              <AirportCode>BCN</AirportCode>
                              <Terminal>1</Terminal>
                           </ArrAirp>
                           <FlightNumber>601</FlightNumber>
                           <FlightTime>120</FlightTime>
                           <OpAirline>AY</OpAirline>
                           <MarkAirline>AY</MarkAirline>
                           <AircraftType>321</AircraftType>
                           <DepartureTime>09:30</DepartureTime>
                           <ArrivalTime>11:30</ArrivalTime>
                           <StartDate>2023-12-24</StartDate>
                           <EndDate>2025-12-31</EndDate>
                           <OperatedDaysOfWeek>
                              <DayOfWeek>Monday</DayOfWeek>
                              <DayOfWeek>Tuesday</DayOfWeek>
                              <DayOfWeek>Wednesday</DayOfWeek>
                              <DayOfWeek>Thursday</DayOfWeek>
                              <DayOfWeek>Friday</DayOfWeek>
                              <DayOfWeek>Saturday</DayOfWeek>
                              <DayOfWeek>Sunday</DayOfWeek>
                           </OperatedDaysOfWeek>
                           <BaseClasses>
                              <a:BaseClass>Business</a:BaseClass>
                              <a:BaseClass>Economy</a:BaseClass>
                              <a:BaseClass>First</a:BaseClass>
                           </BaseClasses>
                           <ETicket>true</ETicket>
                           <OperatingFlightNumber>601</OperatingFlightNumber>
                        </ScheduleSegment>
                     </ScheduleSegments>
                  </ScheduleFlight>
                  <ScheduleFlight>
                     <a:ID i:nil="true"/>
                     <SourceID>-10000</SourceID>
                     <TypeInfo i:nil="true"/>
                     <MandatoryLatinNames>false</MandatoryLatinNames>
                     <ScheduleSegments>
                        <ScheduleSegment>
                           <a:ID>1</a:ID>
                           <DepAirp>
                              <AirportCode>CDG</AirportCode>
                              <Terminal>2F</Terminal>
                           </DepAirp>
                           <ArrAirp>
                              <AirportCode>BCN</AirportCode>
                              <Terminal>1</Terminal>
                           </ArrAirp>
                           <FlightNumber>603</FlightNumber>
                           <FlightTime>30</FlightTime>
                           <OpAirline>AY</OpAirline>
                           <MarkAirline>AY</MarkAirline>
                           <AircraftType>321</AircraftType>
                           <DepartureTime>12:00</DepartureTime>
                           <ArrivalTime>12:30</ArrivalTime>
                           <StartDate>2024-07-01</StartDate>
                           <EndDate>2025-12-31</EndDate>
                           <OperatedDaysOfWeek>
                              <DayOfWeek>Monday</DayOfWeek>
                              <DayOfWeek>Tuesday</DayOfWeek>
                              <DayOfWeek>Wednesday</DayOfWeek>
                              <DayOfWeek>Thursday</DayOfWeek>
                              <DayOfWeek>Friday</DayOfWeek>
                              <DayOfWeek>Saturday</DayOfWeek>
                              <DayOfWeek>Sunday</DayOfWeek>
                           </OperatedDaysOfWeek>
                           <BaseClasses>
                              <a:BaseClass>Business</a:BaseClass>
                              <a:BaseClass>Economy</a:BaseClass>
                              <a:BaseClass>First</a:BaseClass>
                           </BaseClasses>
                           <ETicket>true</ETicket>
                           <OperatingFlightNumber>603</OperatingFlightNumber>
                        </ScheduleSegment>
                     </ScheduleSegments>
                  </ScheduleFlight>
                  <ScheduleFlight>
                     <a:ID i:nil="true"/>
                     <SourceID>-10000</SourceID>
                     <TypeInfo i:nil="true"/>
                     <MandatoryLatinNames>false</MandatoryLatinNames>
                     <ScheduleSegments>
                        <ScheduleSegment>
                           <a:ID>1</a:ID>
                           <DepAirp>
                              <AirportCode>CDG</AirportCode>
                              <Terminal>2F</Terminal>
                           </DepAirp>
                           <ArrAirp>
                              <AirportCode>BCN</AirportCode>
                              <Terminal>1</Terminal>
                           </ArrAirp>
                           <FlightNumber>605</FlightNumber>
                           <FlightTime>90</FlightTime>
                           <OpAirline>AY</OpAirline>
                           <MarkAirline>AY</MarkAirline>
                           <AircraftType>321</AircraftType>
                           <DepartureTime>16:00</DepartureTime>
                           <ArrivalTime>17:30</ArrivalTime>
                           <StartDate>2023-01-14</StartDate>
                           <EndDate>2025-12-31</EndDate>
                           <OperatedDaysOfWeek>
                              <DayOfWeek>Monday</DayOfWeek>
                              <DayOfWeek>Tuesday</DayOfWeek>
                              <DayOfWeek>Wednesday</DayOfWeek>
                              <DayOfWeek>Thursday</DayOfWeek>
                              <DayOfWeek>Friday</DayOfWeek>
                              <DayOfWeek>Saturday</DayOfWeek>
                              <DayOfWeek>Sunday</DayOfWeek>
                           </OperatedDaysOfWeek>
                           <BaseClasses>
                              <a:BaseClass>Business</a:BaseClass>
                              <a:BaseClass>Economy</a:BaseClass>
                              <a:BaseClass>First</a:BaseClass>
                           </BaseClasses>
                           <ETicket>true</ETicket>
                           <OperatingFlightNumber>605</OperatingFlightNumber>
                        </ScheduleSegment>
                     </ScheduleSegments>
                  </ScheduleFlight>
               </Flights>
            </a:ResponseBody>
         </ScheduleSearchResult>
      </ScheduleSearchResponse>
   </s:Body>
</s:Envelope>