XML Transaction : Air_Availability Query

Query:
Air
Availability

Description

Lists flight availability and schedule information. An availability lists all flights with at least one seat available for sale or waitlist. A schedule lists all flights operated by all airlines that submit schedule information to Amadeus.

Query : XML Tree

Click on the +/- symbol to expand/collapse an element.

-<Air_Availability_Query>
<FromCity/>

<ToCity/>

<DepartureDate/>

<DepartureTime/>

<ShowAll/>

<NumOfSeats/>

<Class1/>

<Class2/>

<Class3/>

<AirlinePref1/>

<AirlinePref2/>

<AirlinePref3/>

<FlightNum/>

<ConnectingCity1/>

<ConnectingCompany1/>

<ConnectingTime1/>

<ConnectingCity2/>

<ConnectingCompany2/>

<ConnectingTime2/>

<CarrierPreferred/>

<DirectAccess/>

<SortOrder/>

<Charter/>

<SevenDaySearch/>

<PageNum/>

<PageSize/>

</Air_Availability_Query>

Xml Model:

<Air_Availability_Query> <FromCity/> <ToCity/> <DepartureDate/> <DepartureTime/> <ShowAll/> <NumOfSeats/> <Class1/> <Class2/> <Class3/> <AirlinePref1/> <AirlinePref2/> <AirlinePref3/> <FlightNum/> <ConnectingCity1/> <ConnectingCompany1/> <ConnectingTime1/> <ConnectingCity2/> <ConnectingCompany2/> <ConnectingTime2/> <CarrierPreferred/> <DirectAccess/> <SortOrder/> <Charter/> <SevenDaySearch/> <PageNum/> <PageSize/> </Air_Availability_Query>

Query : Field Descriptions

Field	Standard Length and Description
FromCity	(Maximum 25 characters). Departure city or airport code, three-letter code. Example : PAR, CDG, ORY, NYC, EWR, JFK, LGA, ...
ToCity	(Maximum 25 characters). Arrival city or airport code, three-letter code. Example : PAR, CDG, ORY, NYC, EWR, JFK, LGA, ...
DepartureDate	(Maximum 9 characters). Departure date. The date format is DDMMMYYYY.
DepartureTime	(Maximum 4 characters). Departure time. The time format is HHMM.
ShowAll	(Maximum 1 characters). Indicator used to determine if an availability or a schedule should be displayed. Two possible values : T = Display a schedule F = Display an availability . The default is F. (Note: Always enter the value in Upper Case .)
NumOfSeats	(Maximum 2 characters). Number of seats. To limit the request to specific number of seats. The system lists the flights and the classes of service for these flights that meet this criteria.
Class1	(Maximum 2 characters). Class of service, one or two-letter code. To limit the request to a specific class. Can be combined with the Class2 and Class3 fields ( if multiple classes of services ). Example : Y, C, YN, CN, ...

Query : Field Descriptions

Field	Standard Length and Description
Class2	(Maximum 2 characters). Class of service, one or two-letter code. To limit the request to a specific class. Can be combined with the Class1 and Class3 fields ( if multiple classes of services ). Example : Y, C, YN, CN, ...
Class3	(Maximum 2 characters). Class of service, one or two-letter code. To limit the request to a specific class. Can be combined with the Class1 and Class2 fields ( if multiple classes of services ). Example : Y, C, YN, CN, ...
AirlinePref1	(Maximum 3 characters). Airline code, two or three-letter code. To limit the request to one particular airline. Can be combined with the AirlinePref2 and AirlinePref3 fields. Example : AF or AFR for Air France.
AirlinePref2	(Maximum 3 characters). Airline code, two or three-letter code. To limit the request to one particular airline. Can be combined with the AirlinePref1 and AirlinePref3 fields. Example : AF or AFR for Air France.
AirlinePref3	(Maximum 3 characters). Airline code, two or three-letter code. To limit the request to one particular airline. Can be combined with the AirlinePref1 and AirlinePre2 fields. Example : AF or AFR for Air France.
FlightNum	(Maximum 4 characters). Flight number. To request a specific flight number together with the preferred airline code.
ConnectingCity1	(Maximum 25 characters). Connecting city or airport code, three-letter code. To request availability over one preferred connecting point. Can be combined with the ConnectingCity2 field. Example : PAR, CDG, ORY, NYC, EWR, JFK, LGA, ...

Query : Field Descriptions

Field	Standard Length and Description
ConnectingCompany1	(Maximum 3 characters). Airline code, two or three-letter code. To request availability over one preferred airline. This field works with the ConnectingCity1 field. Example : AF or AFR for Air France.
ConnectingTime1	(Maximum 4 characters). Connecting time. To specify a connecting time that deviates from official minimum connecting time. This field is used in conjuntion with the ConnectingCity1 field.
ConnectingCity2	(Maximum 25 characters). Connecting city or airport code, three-letter code. To request availability over one preferred connecting point. This field can be used in conjuntion with the ConnectingCity1 field. Example : PAR, CDG, ORY, NYC, EWR, JFK, LGA, ...
ConnectingCompany2	(Maximum 3 characters). Airline code, two or three-letter code. To request availability over one preferred airline.This field is used in conjuntion with the ConnectingCity2 field. Example : AF or AFR for Air France.
ConnectingTime2	(Maximum 4 characters). Connecting time. To specify a connecting time that deviates from official minimum connecting time.This field is used in conjuntion with the ConnectingCity2 field.
CarrierPreferred	(Maximum 3 characters). Airline code, two or three-letter code. To request availabity over one preferred airline. Example : AF or AFR for Air France. For an "Availability by Alliance", you must enter an Alliance Code. Example : OW for ONE WORLD.
DirectAccess	(Maximum 1 characters). Indicator used to determine if Direct Access availability should be used or not. T = Use Direct Access - must specify an airline in Airlinepref1 field. F = Use Standard Access.

Query : Field Descriptions

Field	Standard Length and Description
SortOrder	(Maximum 1 characters). Option used to specify the order in which the flights are sorted (e.g. by arrival time, by elapsed time). *For a list of valid options, see AIR_Sort_Order codes.*
Charter	(Maximum 1 characters). Indicator used to determine if the availability response can contain charter flights or not. T = Can contain charter flights F = Cannot contain charter flights OPTION NOT AVAILABLE.
SevenDaySearch	(Maximum 1 characters). Indicator used to determine if the availability request should perform a seven-day search or not. The system seaches within a seven day time period starting with the date of departure. T = Perform a 7 day search F = Do not perform a 7 day search
PageNum	(Maximum 2 characters). Page Number. OPTION NOT AVAILABLE.
PageSize	(Maximum 180 characters). Page size. OPTION NOT AVAILABLE.

Guidelines and Rules

	Mandatory parameter.
	Node.
N/A	Stand for Not Applicable.
Common Usage	*Common usage* is specified in some descriptions to indicate the length of a field as it is used within the travel industry. For example, the maximum length specified for FROMCITY is 10, however the *Common Usage Length* is 3 (e.g MIA for MIAMI).