AirSearch

Parameters	Description	Optional
SessionId	A unique identifier used to define a specific session in which a user is granted access to an API for a certain period. You should get this parameter from the response of the Login Method.	M
SessionToken	Unique authentication used to represent a specific session in which a user has access to an API. You should get this parameter from the response of the Login Method.	M

Parameters	Description	Optional
FlightType	Specifies the flight type. The possible values are: OW = One-way flight RT = Round-trip flight MP = Multi-city flight	M
FlightClass	Specifies the flight class. The possible values are: Economy Business First Comfort	M
IfDirectFlightsOnly	If non-stop (direct) flights are desired in the AirSearch results, this parameter should be set to True.	O
IfRefundablesOnly	If only flights with cancellation and refundable features are desired in the AirSearch results, this parameter should be set to True.	O
SearchTimeoutMilliseconds	This parameter defines the duration (in milliseconds) within which the response must be returned. It is recommended to set this parameter to 30,000 milliseconds (30 seconds) to ensure timely responses.	M
PreferedAirlines	If results from only specific airlines are desired, the two-letter code of that airline can be set.	O

Parameters	Description	Optional
PaxCode	This parameter specifies the type of passenger. The possible types of passengers are as follows: ADT = Adult CHD = Child INF = Infant	M
PaxCount	Specifies how many of the selected type of passenger there will be.	M

Parameters	Description	Optional
ArrivalDay		M
DepartureDay	The desired day for the flight search results to be displayed is specified.	M
SequenceNo	This is the given sequence number for each segment. For instance, a one-way flight is set with SequenceNo 1, but in round-trip flights, the outbound flight is SequenceNo 1, and the return flight is set as SequenceNo 2. In multi-leg flights, the SequenceNo is incremented by one in direct proportion to the number of segments.	M

Parameters	Description	Optional
Code	The three-letter codes of the departure and arrival airports or cities must be set.	M
CountryCode	The two-letter country codes of the countries where the departure and arrival airports or cities are located must be set.	M
IsCity	Determines whether a search for airports or cities will be conducted at the departure or arrival location. If the IsCity parameter is set to True, the city's three-letter code should be entered into the Code parameter, and the flight search will then include all airports located in that city.	M

Parameters	Description	Optional
Code	The three-letter codes of the departure and arrival airports or cities must be set.	M
CountryCode	The two-letter country codes of the countries where the departure and arrival airports or cities are located must be set.	M
IsCity	Determines whether a search for airports or cities will be conducted at the departure or arrival location. If the IsCity parameter is set to True, the city's three-letter code should be entered into the Code parameter, and the flight search will then include all airports located in that city.	M

Field	Description
HasError	It is a status used to indicate whether an error occurred during the process. true: Indicates that an error occurred during the process. In this case, the payment transaction may have failed, and further error details should be reviewed. false: Indicates that the process was completed without errors and is generally considered successful.
ServiceError	ServiceError represents a technical or business-related error that occurs during the payment process. This error is usually returned in the form of a code or message, helping the developer understand the issue.
SystemLogs	It typically contains information or error messages related to system events that occur during the transaction. This field provides details about the situations encountered by the API server during the payment process.
SearchId	It is a unique ID used to track and manage the relevant search results, allowing the user to be presented with the same search results again for a specific period.
ShoppingFileId	It is typically a unique identifier that defines the flight search query results for a specific session or transaction.

Index	Field	Description
1	BaseFare	The fare represents the cost of the ticket. This cost refers exclusively to the flight itself and does not include any additional expenses such as taxes, fees, or extra services.
2	BookingCode	This field is used to retrieve or query the unique identifier of a flight reservation. Typically, this is an alphanumeric code generated at the time of booking, which is used to track your ticket, flight details, and reservation status.
3	Currency	This field is used to query or set the currency used for ticket prices, fees, and other financial transactions. It is typically employed in operations such as purchasing flight tickets, pricing additional services, or making payments for services, to determine the relevant currency.
4	ExchangeCurrencyCode	It is necessary to convert ticket prices, fees, or other services into the currency of the user's location or the local market where the transaction takes place. This field is typically used to determine or query the code of the target currency during currency conversions. This method is especially important for international flights or for airlines that accept different currencies.
5	IsRefundable	Whether a ticket is refundable. This field provides information on whether the ticket purchased by the passenger can be refunded under certain conditions.
6	LastSellerCommission	The commission amount/service fee determined by the seller (client).
7	NetFare	It refers to the base fare to be charged to a passenger for a flight.
8	ProductId	It refers to a unique product identifier (ID) defined for a specific flight or service. This ID enables the identification and processing of the flight or additional service by the system.
9	ProviderId	It is a code that identifies the service provider offering or presenting the flight option. This code specifies the company or system providing the flight information.
10	SystemServiceFee	This element represents the system service fee associated with a transaction or service. The value '3' indicates the amount of the system service fee charged.
11	ServiceFee	This element represents the service fee associated with a transaction or service. For example, if the service fee amount is 3, it is indicated as 3 in this field. ServiceFee= SystemServiceFee+LastSellerCommission
12	ProductItemId	This element contains a unique identifier (UUID) corresponding to a specific product item within the Trevoo.WS.Entities.Shopping schema. For example, the value `289af8a3-554b-469c-b28a-7ace0feb5487` uniquely identifies the product item associated with this XML entity.
13	Taxes	This XML element is used to denote the total amount of taxes applicable to a transaction or service within the Trevoo.WS.Entities.Shopping schema.
14	BookingProvider	It refers to the provider or platform through which a specific flight reservation or ticketing is made.
15	BookingProviderId	It specifies the ID of the Booking Provider.
16	Duration	It refers to the total duration of a specific flight. This duration covers the time from the aircraft's departure point to its arrival destination and is usually expressed in hours and minutes.
17	TotalFare	The TotalFare element represents the complete amount to be paid for a transaction or service. TotalFare=BaseFare+Taxes+ServiceFee
18	Type	This parameter indicates the type of product associated with the reservation or booking. It is typically used in the aviation industry to identify and specify the service type for a booking or ticket. The Type field usually includes the following product types: 'Flight': Represents an airline flight reservation or ticket. 'Ancillary': Used for additional services (e.g., baggage, meals, seat selection). 'Service': Defines extra services such as check-in, special service requests, or transfer services. 'Package': Refers to package bookings that include flights along with hotel, car rental, or other services.
19	IsReservable	"IsReservable" is a field that indicates whether a specific flight segment is reservable. This field is usually presented as a boolean value in the form of "true" or "false": true: This flight segment is reservable, meaning a seat can be reserved and ticketing processes can be carried out for this segment. false: This flight segment is not reservable, meaning a seat cannot be reserved and ticketing processes cannot be carried out for this segment.
20	OptionFlag	"OptionFlag" is a field that indicates additional options or specific conditions for a particular flight segment. This field is typically used to mark special features or specific situations of the segment.

Index	Field	Description
1	BrandedFareItemId	It uniquely identifies a specific "branded fare" option, providing a unique ID corresponding to each package.

Index	Field	Description
1	PassengerCount	It indicates the number of passengers included in the pricing for each Branded Fare.
2	PassengerType	It is a field that specifies the passenger's category or type. ADT (Adult): Adult passenger (typically 12 years and older). CHD (Child): Child passenger (typically between 2-11 years old). INF (Infant): Infant passenger (typically under 2 years old, traveling on a lap).

Index	Field	Description
1	BrandId	Identifier that represents the brand identity of a specific airline or scheduled flight. This identifier helps distinguish between different fare levels or service packages offered to passengers. For example, some airlines offer different classes and service packages such as economy, premium economy, and business class under different brand identities. BrandId is used to distinguish these different service packages and provide information about a specific class or service package.BrandId is an identifier that represents the brand identity of a specific airline or scheduled flight. This identifier helps distinguish between different fare levels or service packages offered to passengers. For example, some airlines offer different classes and service packages such as economy, premium economy, and business class under different brand identities. BrandId is used to distinguish these different service packages and provide information about a specific class or service package.
2	BookingClass	"BookingClass" refers to the reservation class of a specific branded fare item. This field determines the class in which the passenger will travel and the services, flexibilities, and advantages offered by that class. It is usually represented by a single letter or a combination of letters.
3	CabinClass	It specifies the cabin class in which the passenger will be seated during the flight. This field defines different cabin classes that passengers can choose from based on their flight experiences and level of service preferences.
4	FareBasisCode	"FareBasisCode" refers to the basic fare code that determines the pricing rules and conditions of the ticket. This code defines the fare class applicable to a flight and the flexibility, change, and cancellation conditions of the ticket. It is usually presented as a combination of letters and numbers (e.g., Y26, QFL, or E14NR). The FareBasisCode field indicates the pricing rules and conditions under which the ticket is sold.
5	FreeBaggageAllowanceId	FreeBaggageAllowanceId is an identifier that defines the free baggage allowance offered for a specific flight or fare class. This identifier indicates how much free baggage allowance passengers have when traveling in a specific fare class.
6	SeatsAvailable	It refers to the number of seats available for booking on a flight. This indicates the occupancy rate and remaining capacity of the flight.
7	SegmentId	SegmentId is an identifier that represents the identity of a specific flight or flight segment. Particularly in cases of multi-stop or connecting flights, there are different SegmentIds for each flight section. This allows passengers and systems to understand which part of a particular flight is being referred to.

Index	Field	Description
1	Amount	This field specifies the monetary value associated with the change policy of a flight. It indicates the cost that applies when a policy is changed. This ensures accurate and transparent management of fees related to policy Cancellation for flights.
2	Applicability	It is a field that specifies under which conditions a ticket can be canceled and in which situations the cancellation is valid. BeforeDeparture → The cancellation policy applies before the flight departs. AfterDeparture → The cancellation policy applies after the flight has departed.
3	MinutesToDeparture	It indicates the amount of time remaining (in minutes) until a flight's departure and determines the impact of this duration on the cancellation of the ticket. It specifies the remaining time for a ticket to be canceled and describes the effect of this time on cancellation policies. This information helps passengers understand how much time they have in case of a flight cancellation and how the cancellation can be executed.
4	Currency	It indicates the currency in which the specified monetary values are denominated. This field specifies the currency used for calculating and displaying ticket prices, taxes, service fees, and other costs, such as TRY (Turkish Lira), USD (US Dollar), EUR (Euro), and GBP (British Pound).
5	IsRefundable	Whether a ticket is refundable. This field provides information on whether the ticket purchased by the passenger can be refunded under certain conditions.

Index	Field	Description
1	Amount	This field specifies the monetary value associated with the change policy of a flight. It indicates the cost that applies when a policy is changed. This ensBrandedFaresures accurate and transparent management of fees related to policy changes for flights.
2	Applicability	It refers to a field that specifies under what conditions and in what manner ticket changes can be implemented. BeforeDeparture: Refers to the change policies that can be applied before the flight departs. AfterDeparture: Specifies changes or penalties applicable after the flight has departed.
3	MinutesToDeparture	It expresses how much time (in minutes) is left until a flight's departure and specifies the impact of this time on ticket changes. It determines the permissible time frame for ticket changes and shows how long before the flight passengers can make changes to their tickets.
4	Currency	It indicates the currency in which the specified monetary values are denominated. This field specifies the currency used for calculating and displaying ticket prices, taxes, service fees, and other costs, such as TRY (Turkish Lira), USD (US Dollar), EUR (Euro), and GBP (British Pound).
5	IsChangeable	This field provides information on whether the ticket purchased by the passenger can be exchanged under certain conditions.

Index	Field	Description
1	TotalFare	The TotalFare element represents the complete amount to be paid for a transaction or service. TotalFare=BaseFare+Taxes+ServiceFee
2	TotalTaxes	It includes the total amount of all taxes added to the passenger's ticket price.

Index	Field	Description
1	BrandCode	Is a code that represents the brand identity of a specific airline or flight. This code is used to distinguish between different fare levels or service packages. BrandCode helps passengers determine which services or benefits they will receive when making a reservation. Airlines typically offer various service packages under different brand identities, and these packages may include different features, benefits, or limitations.
2	BrandId	Identifier that represents the brand identity of a specific airline or scheduled flight. This identifier helps distinguish between different fare levels or service packages offered to passengers. For example, some airlines offer different classes and service packages such as economy, premium economy, and business class under different brand identities. BrandId is used to distinguish these different service packages and provide information about a specific class or service package.BrandId is an identifier that represents the brand identity of a specific airline or scheduled flight. This identifier helps distinguish between different fare levels or service packages offered to passengers. For example, some airlines offer different classes and service packages such as economy, premium economy, and business class under different brand identities. BrandId is used to distinguish these different service packages and provide information about a specific class or service package.
3	BrandName	BrandName refers to the name of a specific fare class or service package. BrandName is used to describe the different service levels or benefit packages offered by airline companies.

Index	Field	Description
1	Application	That specifies the conditions and manner under which a particular fare class or service package is applied. This field explains the circumstances in which a specific fare or service package is valid and the restrictions that apply to it. N : Not Applicable F : Free C : Chargeable
2	DisplayType	DisplayType is a field that specifies how a particular fare or service package will be displayed to the user. DisplayType controls how this information is presented in the user interface.
3	RuleDescription	RuleDescription contains the description of the rules and conditions associated with a specific fare class or service package. This description aims to provide passengers with detailed information about a particular fare or service package. The RuleDescription field typically includes information such as: • Baggage Allowance: Free baggage allowance, carry-on baggage allowance, additional baggage fees, etc. • Change and Cancellation Policies: Reservation changes, cancellations, refund conditions, etc. • Services and Benefits: Included services (meal service, lounge access, extra legroom, etc.). • Other Conditions: Special situations, restrictions, additional fees, etc.
4	ServiceGroup	That categorizes the services and benefits associated with a specific fare class or service package. This field allows for the presentation of services and benefits offered to passengers under specific groups.

Index	Field	Description
1	Allowance	The "allowance" method is commonly used to access information about passengers' baggage entitlements, detailing how much luggage they can carry. This method may include specifics such as the maximum weight and dimensions allowed for both carry-on and checked baggage. Additionally, it can provide information on fees for excess baggage and regulations for special items, such as sports equipment or musical instruments.
2	Category	Specifies the type of baggage. Example: "Checked" indicates that the baggage is checked in at the airport and transported in the aircraft's cargo hold. Example: "Cabin" indicates that the baggage is carried into the cabin by the passenger and stored in the overhead bin or under the seat.
3	Type	Defines how the quantity of the baggage is measured. Example: "Weight" indicates that the baggage is measured based on its weight. Example: "Piece" indicates that the baggage is measured based on the number of pieces.
4	Unit	Indicates the unit of measurement for the baggage. Example: "K" represents kilograms. Example: "P"
5	PaxType	It refers to the classification of passengers based on their age and status. It is important for ticket pricing, baggage allowance, service level, and other passenger services. The PaxType field helps airlines and travel agencies accurately classify passenger information and develop appropriate service and pricing strategies for each passenger type.

Index	Field	Description
1	AvailableSeats	It refers to the number of seats available for booking on a flight. This indicates the occupancy rate and remaining capacity of the flight.
2	BookingClassCode	This element specifies the booking class code associated with a travel booking or reservation. For example, the value V represents the specific booking class code assigned to the booking. Booking class codes are used in airline bookings to indicate the fare type, availability, and restrictions associated with the reserved seat or ticket.
3	IsPromo	This element indicates whether a particular item, service, or booking is promotional. It returns a boolean value of `true` or `false`. A value of `true` indicates that the service or booking is classified as non-refundable. This element helps distinguish promotional items from regular offers in the context of a reservation or booking system.
4	SegmentSequenceNo	It is used to sequence the segments of a flight. This field is a sequence number indicating which part of the journey is being referred to. For routes containing multiple flight segments, this field ensures that each segment is in the correct order and position.

Index	Field	Description
1	SegmentId	SegmentId is an identifier that represents the identity of a specific flight or flight segment. Particularly in cases of multi-stop or connecting flights, there are different SegmentIds for each flight section. This allows passengers and systems to understand which part of a particular flight is being referred to.
2	ArrivalDay	It indicates the day when the airplane reaches its destination. This information provides users with details about the flight's arrival date and day. For example, knowing on which day the flight will arrive is particularly important for long-haul flights across different time zones.
3	ArrivalTime	"ArrivalTime" refers to the arrival time of the flight. This field indicates the time when the flight lands at the designated destination airport. It is usually presented in date and time format (e.g., YYYY-MM-DDTHH) and helps passengers know when the flight will arrive.
4	BookingClass	"BookingClass" refers to the flight reservation class. This field indicates the class in which the passenger will travel during the flight and is usually represented by a single letter. For example: Economy Business First Comfort
5	DepartureDay	"DepartureDay" refers to the departure day of the flight. This field indicates the scheduled departure date of the flight and is usually presented in date format (e.g., YYYY-MM-DD).
6	DepartureTime	"DepartureTime" refers to the departure time of the flight. This field indicates the scheduled departure time of the flight and is usually presented in hour and minute format (e.g., HH).
7	DestinationCode	"DestinationCode" refers to the destination of the flight. This field indicates the code of the airport where the flight will arrive. Usually, three-letter airport codes determined by IATA (International Air Transport Association) are used. For example: JFK: New York John F. Kennedy Airport LHR: London Heathrow Airport CDG: Paris Charles de Gaulle Airport
8	Duration	"Duration" refers to the total duration of the flight. This field indicates the time elapsed from the departure point to the arrival point and is presented in minutes.
9	Equipment	Refers to the type or model of aircraft used for the flight. This field indicates which aircraft model will be used for a specific flight segment and is usually presented in three-letter codes determined by IATA.
10	FareBasis	"FareBasis" refers to the basic fare code that determines the pricing rules and conditions of the ticket. This code defines the fare class applicable to a flight and the flexibility, change, and cancellation conditions of the ticket. It is usually presented as a combination of letters and numbers (e.g., Y26, QFL, or E14NR). The FareBasis field indicates the pricing rules and conditions under which the ticket is sold.
11	FareType	It refers to the fare type or tariff of the booked ticket. The 'FareType' indicates which fare category or class the ticket belongs to.
12	FlightNumber	"FlightNumber" refers to the number that identifies a specific flight. This number is uniquely assigned to each flight by the airline and is usually used in conjunction with the airline code. For example, "BA123" denotes a British Airways flight, while "TK270" refers to a Turkish Airlines flight.
13	MarketingAirline	Refers to the airline that markets and sells the flight. This airline is considered the brand that appears during the booking and ticketing process and is usually represented by a two-letter code assigned by IATA. For example: AA: American Airlines TK: Turkish Airlines BA: British Airways
14	OD_DestinationCode	"OD_DestinationCode" refers to the final destination of the trip.
15	OD_OriginCode	"OD_OriginCode" refers to the origin point of the flight.
16	OperatingAirline	"OperatingAirline" refers to the airline that actually operates the flight. This field may differ from the airline that markets or tickets the flight (MarketingAirline). The OperatingAirline field indicates the airline that physically operates the flight and is usually represented by a two-letter code assigned by IATA (International Air Transport Association).
17	OriginCode	"OriginCode" refers to the origin point of the flight. This field indicates the code of the airport where the flight begins and usually uses the three-letter airport codes determined by IATA (International Air Transport Association).
18	SelectedBrandedFareItemId	It is a unique identifier representing the selected branded fare type for a specific flight segment.
19	SequenceNo	"SequenceNo" refers to the number that indicates the order or position of a specific segment in a flight search. This field is used to denote the sequence of each segment in cases where there are multiple flight segments. For example, a flight route might consist of multiple segments as follows: Segment 1: Istanbul (IST) -> London (LHR) Segment 2: London (LHR) -> New York (JFK) In this example, the SequenceNo could be: Segment 1: SequenceNo = 1 Segment 2: SequenceNo = 2

¶ Introduction

¶ Steps:

¶ Steps:

¶ Limits and Features

¶ How to Make an AirSearch Request?

¶ Differences Between FlightOptions and RecommendationBox

¶ FlightOption:

¶

¶ RecommendationBox:

¶

¶ Basic Request Structure

¶ AirSearch Request

¶ AuthenticationHeader

¶ Form

¶ From/Options

¶ From/PaxItems

¶ From/Segments

¶ From/Segments/Origin

¶ From/Segments/Destination

¶ AirSearch Response

¶ Result

¶ FlightOption

¶ FlightOption/BrandedFares

¶ FlightOption/BrandedFares/BrandedFareItems

¶ FlightOption/BrandedFares/BrandedFareItem/BrandedFarePassengers

¶ FlightOption/BrandedFares/BrandedFareItem/BrandedFarePassengers/FareComponents

¶ FlightOption/BrandedFares/BrandedFareItem/BrandedFarePassengers/PassengerFareInfo

¶ FlightOption/BrandedFares/BrandedFareItem/BrandedFarePassenger/Policy

¶ FlightOption/BrandedFares/BrandedFareItem/BrandedFarePassenger/Policy/CancellationPolicies

¶ FlightOption/BrandedFares/BrandedFareItem/BrandedFarePassenger/Policy/ChangePolicies

¶ FlightOption/BrandedFares/BrandedFareItem/TotalFareInfo

¶ FlightOption/BrandedFares/BrandedItem

¶ FlightOption/BrandedFares/BrandedItem/BrandedRule

¶ FlightOption/FreeBaggageAllowance

¶ FlightOption/FreeBaggageAllowance/PaxBaggageAllowance

¶ FlightOption/PaxFareItem

¶ FlightOption/SegmentAvailabilities

¶ FlightOption/Segments