- 1 Amadeus Flight Search API and Fare Families: Among the Flight Search API’s upgraded features, Airline Fare Families help customers better choose fares: Included in them are selection of priority boarding and additional baggage. This assists the travelers to make a wise decision and increases the quality of travels.
- 2 Fare_MasterPricerTravelBoardSearch API: By application of Master Pricer technology this API offers the best flight prices. It also enables composed fare search and the user has options to view fare family name and the services related to it at several levels.
- 3 Fare_PriceUpsellWithoutPNR API: Some of these APIs allow for the search of the optimal fare for a route without the creation of a PNR. They have choices for additional services that may be sold separately and services that can be tailored to the customers’ requirement.
Introduction to Fare Families
Amadeus organizes airline fares into Fare Families through its Flight Search API. Each fare family groups together similar fares and the perks that come with them — things like priority boarding, extra baggage, or seat selection.
This structure helps airlines manage their pricing more clearly. It also helps travelers understand exactly what they’re paying for.
Fare Families can also open the door to upgrades. If you want more legroom, flexible changes, or a checked bag included, choosing a higher fare family often gets you there — without booking a full business-class ticket. Whether you’re booking through a mobile app or a website, understanding fare families helps you choose the option that actually fits your trip.
FLIGHT SEARCH API
The Amadeus Flight Offers Search API is part of a larger set of SOAP/XML APIs built for the travel industry. It’s used by major travel brands to search flights, retrieve pricing, and access detailed fare content.
One of the key APIs in this group is Fare_MasterPricerTravelBoardSearch, which we’ll cover next.
Fare_MasterPricerTravelBoardSearch
The Amadeus API Fare_MasterPricerTravelBoardSearch is a low fare search engine that allows developers to retrieve the best price for flights based on the latest Master Pricer technology.
This API is part of the Amadeus travel APIs that power some of the biggest names in the travel industry. Here are some key points about the Fare_MasterPricerTravelBoardSearch API:
The Fare_MasterPricerTravelBoardSearch API is used to search for flights and retrieve pricing information based on a variety of search criteria, such as origin and destination airports, travel dates, and number of passengers.
- This is the low fare search engine Amadeus uses to retrieve the best price for flights, based on their latest Master Pricer TravelBoard technology.
- Airline Fare Family information in Master Pricer’s replies can be activated by an internal Amadeus parameter at the Office ID level and triggered by an input option (FFI) with three values: 1, 2, or 3.
1: Only Fare Family name at Fare component level is returned.
2: Fare Family name at Fare component level and resulting Fare Family name at requested segment level are returned.
3: Fare Family name at Fare component level, resulting Fare Family name at requested segment level, and the list of services are returned.
API request parameters:
The request parameters are the same as the normal shopping flow requests. Just update the fareOptions tag to retrieve the Fare Families information.
API Request :
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:sec="http://xml.amadeus.com/2010/06/Security_v1">
<soap:Header>
<wsse:Security>
<wsse:UsernameToken>
<wsse:Username>WSTSNIBE</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">LrYDb1MvpHN3Jo7wMl4BUG8GehI=</wsse:Password>
<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">MkZUT2NMOWlEYWxVTkd1cEtkSEs=</wsse:Nonce>
<wsu:Created>2023-04-10T05:47:37Z</wsu:Created>
</wsse:UsernameToken>
</wsse:Security>
<sec:AMA_SecurityHostedUser>
<sec:UserID POS_Type="1" RequestorType="U" PseudoCityCode="CPTS128TS" AgentDutyCode="SU"/>
</sec:AMA_SecurityHostedUser>
<zdef947235196:TransactionFlowLink xmlns:zdef947235196="http://wsdl.amadeus.com/2010/06/ws/Link_v1">
.
.
.
</itinerary>
</Fare_MasterPricerTravelBoardSearch>
</soap:Body>
</soap:Envelope>Click Here to view the full code
API Response parameters:
The Fare_MasterPricerTravelBoardSearch response for Fare Family includes the following information for each fare family:
- refNumber: A reference number for the fare family.
- fareFamilyname: The name of the fare family.
- description: A description of the fare family.
- carrier: The airline carrier associated with the fare family.
- services: A list of services associated with the fare family, including a reference number and status. The status can be “INC” for included services or “CHA” for charged services.
- recommendation:A flight recommendation that matches the search criteria.
- segmentFlightRef: Specifies the segment flight reference for the recommendation.
API Response:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:awsl="http://wsdl.amadeus.com/2010/06/ws/Link_v1" xmlns:awsse="http://xml.amadeus.com/2010/06/Session_v3" xmlns:wsa="http://www.w3.org/2005/08/addressing">
<soap:Header>
<wsa:To>http://www.w3.org/2005/08/addressing/anonymous</wsa:To>
<wsa:From>
<wsa:Address>https://nodeD1.test.webservices.amadeus.com</wsa:Address>
</wsa:From>
<wsa:Action>http://webservices.amadeus.com/1ASIWIBETSN/FMPTBQ_21_4_1A</wsa:Action>
<wsa:MessageID>urn:uuid:e9109e16-e16b-e584-39f8-2046ab9f388b</wsa:MessageID>
<wsa:RelatesTo RelationshipType="http://www.w3.org/2005/08/addressing/reply">1d6aee19-5731-4b1e-ba24-9e950f3b5297</wsa:RelatesTo>
<awsl:TransactionFlowLink>
<awsl:Consumer>
<awsl:UniqueID>6bfc01b2-54e0-4eaa-aaff-f74122724d46</awsl:UniqueID>
</awsl:Consumer>
<awsl:Receiver>
<awsl:ServerID>urn:uuid:097a2dbb-b412-52bc-90a7-08577453911e</awsl:ServerID>
</awsl:Receiver>
.
.
.
</itemNumberInfo>
</freeBagAllowanceGrp>
</serviceFeesGrp>
</Fare_MasterPricerTravelBoardSearchReply>
</soap:Body>
</soap:Envelope>Click here to view the full code
PRICE APIs
Fare_PriceUpsellWithoutPNR API:
The Amadeus Fare_PriceUpsellWithoutPNR API is a crucial tool for custom financial software development in the travel industry. It is used to request the best price for an itinerary without having to create the corresponding Passenger Name Record (PNR).
This API allows users to retrieve the best available fares for a given itinerary, along with additional upsell options such as seat selection, baggage allowance, and other ancillary services. Our software development company specializes in offering software development services for the travel industry, including travel software development, cross-platform mobile app development services, and custom API development.
We excel in providing tailored solutions to enhance the financial and healthcare aspects of your business, making us a top choice for custom software development.
API request parameters:
- segmentGroup: Specifies the segment group for the request, including the flight date, board point details, off point details, company details, flight identification, flight type details, and item number.
- The <pricingOptionGroup> and <pricingOptionKey> elements are used in the Amadeus IntegratedPricing API to specify pricing options for a given itinerary. Here’s some information about these elements:
- <pricingOptionGroup>: This element groups together one or more <pricingOptionKey> elements to specify a set of pricing options for the itinerary.
- <pricingOptionKey>: This element specifies a pricing option for the itinerary. The value of the element is a code that identifies the pricing option. For example, the code “
FFH” can be used to specify a Fare Family pricing option. - FFH indicator :- It is possible to use the pricing option FFH in the upsell panel query to retrieve only homogeneous recommendations for the fare components (i.e. same airline and AFF), and to provide the same level of services for a traveler’s complete itinerary.
API Request :
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:sec="http://xml.amadeus.com/2010/06/Security_v1">
<soap:Header>
<wsse:Security>
<wsse:UsernameToken>
<wsse:Username>WSTSNIBE</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">uPjXPDdeWmJUpOej5H/vDq1nSz0=</wsse:Password>
<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">WWxPVVN2M3NYWDNLQjVGRVRKVko=</wsse:Nonce>
<wsu:Created>2022-10-06T10:34:31Z</wsu:Created>
</wsse:UsernameToken>
</wsse:Security>
<sec:AMA_SecurityHostedUser>
<sec:UserID POS_Type="1" RequestorType="U" PseudoCityCode="CPTZA2201" AgentDutyCode="SU"/>
</sec:AMA_SecurityHostedUser>
<zdef-263923279:TransactionFlowLink xmlns:zdef-263923279="http://wsdl.amadeus.com/2010/06/ws/Link_v1">
<zdef-263923279:Consumer>
<zdef-263923279:UniqueID>845286ab-8a85-45ea-a0a3-072cfa5006c8</zdef-263923279:UniqueID>
</zdef-263923279:Consumer>
<zdef-263923279:Receiver>
<zdef-263923279:ServerID>urn:uuid:e9060ecc-055c-5bbf-86a3-2023c246ff1e</zdef-263923279:ServerID>
</zdef-263923279:Receiver>
</zdef-263923279:TransactionFlowLink>
<wsa:To>https://nodeD1.test.webservices.amadeus.com</wsa:To>
<wsa:From>
<wsa:Address>http://www.travelstart.com</wsa:Address>
</wsa:From>
<wsa:Action>http://webservices.amadeus.com/1ASIWIBETSN/TIUNRR_19_2_1A</wsa:Action>
<wsa:MessageID>9c9dcfad-b812-4e57-a509-355e0811e5ad</wsa:MessageID>
<wsa:RelatesTo RelationshipType="http://www.w3.org/2005/08/addressing/unspecified">urn:uuid:ca4cfcca-42f2-02e4-05ff-d135f5e4f6c4</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<Fare_PriceUpsellWithoutPNR>
<passengersGroup>
<segmentRepetitionControl>
<segmentControlDetails>
.
.
.
</Fare_PriceUpsellWithoutPNR>
</soap:Body>
</soap:Envelope>Click here to view the full code
API Response parameters:
The <fareList> element is a part of the Fare_PriceUpsellWithoutPNR Amadeus API, which allows you to specify a list of fares with Fare Family for a given itinerary without creating the corresponding Passenger Name Record (PNR).
Information about the elements within the <fareList> element.
- <validatingCarrier>: This element specifies the airline carrier that validates the fare. The
<carrierCode>element within<carrierInformation>specifies the code for the validating carrier. In the example provided, the validating carrier is “BA” (British Airways). - <paxSegReference>: This element specifies the passenger and segment reference for the fare. The
<refDetails>element within<paxSegReference>specifies the reference qualifier (PA for passenger) and reference number (1) for the fare. - <fareDataInformation>: This element provides information about the fare, including the fare data qualifier, fare amount, and fare currency.
- <fareDataMainInformation>: This element provides the main information about the fare, including the fare data qualifier.
- <fareDataSupInformation>: This element provides supplementary information about the fare, including the fare data qualifier, fare amount, and fare currency.
- <segmentInformation>: This element provides information about the flight segment, including the cabin group, validity information, baggage allowance information, and segment reference.
- <connexInformation>: This element provides information about the connection, including the connection type.
- <segDetails>: This element provides details about the flight segment, including the identification and class of service.
- <fareQualifier>: This element provides information about the fare qualifier, including the primary code, fare basis code, and discount ticket designator.
- <cabinGroup>: This element provides information about the cabin group, including the cabin segment and booking class details.
- <validityInformation>: This element provides information about the validity of the fare, including the business semantics and date/time.
- <bagAllowanceInformation>: This element provides information about the baggage allowance, including the baggage quantity and baggage type.
- <segmentReference>: This element provides information about the segment reference, including the reference qualifier and reference number.
- <sequenceInformation>: This element provides information about the sequence of the segment, including the sequence section and sequence number.
- <fareFamilyDetails>: This tag provides the fare family details for the fare component, including the fare family name and hierarchy.
- <fareFamilyOwner>: This tag provides the company identification for the fare family owner.
API Response:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:awsl="http://wsdl.amadeus.com/2010/06/ws/Link_v1" xmlns:awsse="http://xml.amadeus.com/2010/06/Session_v3" xmlns:wsa="http://www.w3.org/2005/08/addressing">
<soap:Header>
<wsa:To>http://www.w3.org/2005/08/addressing/anonymous</wsa:To>
<wsa:From>
<wsa:Address>https://nodeD1.test.webservices.amadeus.com</wsa:Address>
</wsa:From>
<wsa:Action>http://webservices.amadeus.com/1ASIWIBETSN/TIUNRQ_16_1_1A</wsa:Action>
<wsa:MessageID>urn:uuid:84743049-1c14-9754-09fc-0a1d7df45f05</wsa:MessageID>
<wsa:RelatesTo RelationshipType="http://www.w3.org/2005/08/addressing/reply">1d158c36-6fbc-430f-a67e-4fe40b19cb85</wsa:RelatesTo>
<awsl:TransactionFlowLink>
<awsl:Consumer>
<awsl:UniqueID>533a332c-a6c6-4f7d-a15b-ffdc0577ae32</awsl:UniqueID>
</awsl:Consumer>
<awsl:Receiver>
<awsl:ServerID>urn:uuid:325f2142-1e0f-5f2c-a5bf-fbff150dd8ae</awsl:ServerID>
</awsl:Receiver>
</awsl:TransactionFlowLink>
<awsse:Session TransactionStatusCode="End">
<awsse:SessionId>00OKG37UKW</awsse:SessionId>
<awsse:SequenceNumber>1</awsse:SequenceNumber>
<awsse:SecurityToken>38K7K5PMP4RPM11L7TYKCSBKWK</awsse:SecurityToken>
</awsse:Session>
</soap:Header>
<soap:Body>
<Fare_PriceUpsellWithoutPNRReply xmlns="http://xml.amadeus.com/TIUNRR_16_1_1A">
<fareList>
<pricingInformation>
<tstInformation>
<tstIndicator>I</tstIndicator>
</tstInformation>
<fcmi>0</fcmi>
<bestFareType>LA</bestFareType>
</pricingInformation>
.
.
.
<fareDataSupInformation>
<fareDataQualifier>715</fareDataQualifier>
<fareAmount>88009.00</fareAmount>
<fareCurrency>ZAR</fareCurrency>
</fareDataSupInformation>
</fareComponentDetailsGroup>
<endFareList/>
</fareList>
</Fare_PriceUpsellWithoutPNRReply>
</soap:Body>
</soap:Envelope>Click here to view the full code
Fare_GetFareFamilyDescription API
Fare_GetFareFamilyDescription answers a simple but important question: what’s actually included in this fare?
Airlines, travel agencies, and booking platforms use this API to pull full descriptions of a fare family — seat options, baggage allowances, in-flight perks, and any other amenities tied to that fare. This helps travelers compare fares confidently instead of guessing what’s included.
To use it, you send a request with a fare family code and an optional language code. The API returns the description in that language, using a SOAP interface that requires an authenticated Amadeus system user.
Key Request Elements
- fareInformation – the fare qualifier and rate category (e.g.,
FFfor Fare Family) - itineraryInformation – origin and destination airports
- carrierInformation – the airline’s company code
API request parameters:
The <Fare_GetFareFamilyDescription> tag is used in the Amadeus Fare_GetFareFamilyDescription API to specify a request for fare family descriptions. Here’s some information about the tags within this request:
- <standaloneDescriptionRequest>: This tag groups together the fare information, itinerary information, and carrier information for the request.
- <fareInformation>: This tag specifies the fare information for the request, including the fare qualifier and rate category. In the example, the fare qualifier is FF (Fare Family) and the rate category is BAG (Baggage).
- <discountDetails>: This tag provides additional details about the fare, such as any discounts applied.
- <rateCategory>: This tag specifies the rate category for the fare.
- <itineraryInformation>: This tag specifies the itinerary information for the request, including the origin and destination airports. In the example, the origin is LHR (London Heathrow) and the destination is JNB (Johannesburg).
- <carrierInformation>: This tag specifies the carrier information for the request, including the company identification. In the example, the company identification is BA (British Airways).
- <companyIdentification>: This tag specifies the company identification for the carrier.
API Request:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:sec="http://xml.amadeus.com/2010/06/Security_v1">
<soap:Header>
<wsse:Security>
<wsse:UsernameToken>
<wsse:Username>WSTSNIBE</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">fvkvB3rU6nwKEpXWZEcGtaw+fHc=</wsse:Password>
<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">OWZ5TlZVRWFFU244QjVsd1hOMjc=</wsse:Nonce>
<wsu:Created>2023-01-27T07:47:15Z</wsu:Created>
</wsse:UsernameToken>
</wsse:Security>
<sec:AMA_SecurityHostedUser>
<sec:UserID POS_Type="1" RequestorType="U" PseudoCityCode="CPTS128TS" AgentDutyCode="SU"/>
</sec:AMA_SecurityHostedUser>
<zdef1071666683:TransactionFlowLink xmlns:zdef1071666683="http://wsdl.amadeus.com/2010/06/ws/Link_v1">
<zdef1071666683:Consumer>
<zdef1071666683:UniqueID>8cf7f048-1eff-457f-8388-bb8294b3999b</zdef1071666683:UniqueID>
</zdef1071666683:Consumer>
<zdef1071666683:Receiver>
<zdef1071666683:ServerID>urn:uuid:817dcf79-5c01-5ebf-8335-a1690266b138</zdef1071666683:ServerID>
</zdef1071666683:Receiver>
</zdef1071666683:TransactionFlowLink>
<wsa:To>https://nodeD1.test.webservices.amadeus.com</wsa:To>
<wsa:From>
<wsa:Address>http://www.travelstart.com</wsa:Address>
</wsa:From>
<wsa:Action>http://webservices.amadeus.com/1ASIWIBETSN/TFQFRQ_15_1_1A</wsa:Action>
<wsa:MessageID>fc26112b-2ae6-4f8c-82e8-a7a9a61f3df7</wsa:MessageID>
<wsa:RelatesTo RelationshipType="http://www.w3.org/2005/08/addressing/unspecified">urn:uuid:69f4b17b-fa3a-4354-5549-6d8377cd25f8</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<Fare_GetFareFamilyDescription>
.
.
.
</standaloneDescriptionRequest>
</Fare_GetFareFamilyDescription>
</soap:Body>
</soap:Envelope>Click here to view the full code
API Response parameters:
The tags <fareFamilyDescriptionGroup>, <fareInformation>, <carrierInformation>, <freeFlowDescription>, <ocFeeInformation>, and <errorInformationFareFamily> are used in the response of the Fare_GetFareFamilyDescription Amadeus API to provide information about a specific fare family. Here’s a breakdown of the tags and their meanings:
- <fareFamilyDescriptionGroup>: This tag groups together all the elements that provide information about the fare family.
- <fareInformation>: This tag provides information about the fare family’s discount details, such as the rate category.
- <carrierInformation>: This tag specifies the company that owns the fare family.
- <freeFlowDescription>: This tag provides a free-text description of the fare family, which can include information about the fare family’s level of service and amenities.
- <ocFeeInformation>: This tag provides information about any fees associated with the fare family, such as baggage fees.
- <errorInformationFareFamily>: This tag provides information about any errors or warnings associated with the fare family, such as a warning that not all services may be delivered due to a codeshare flight or interline itinerary.
API Response:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:awsl="http://wsdl.amadeus.com/2010/06/ws/Link_v1" xmlns:awsse="http://xml.amadeus.com/2010/06/Session_v3" xmlns:wsa="http://www.w3.org/2005/08/addressing">
<soap:Header>
<wsa:To>http://www.w3.org/2005/08/addressing/anonymous</wsa:To>
<wsa:From>
<wsa:Address>https://nodeD1.test.webservices.amadeus.com</wsa:Address>
</wsa:From>
<wsa:Action>http://webservices.amadeus.com/1ASIWIBETSN/TFQFRQ_15_1_1A</wsa:Action>
<wsa:MessageID>urn:uuid:bfbff828-8928-d314-1508-4d0dc912794c</wsa:MessageID>
<wsa:RelatesTo RelationshipType="http://www.w3.org/2005/08/addressing/reply">fc26112b-2ae6-4f8c-82e8-a7a9a61f3df7</wsa:RelatesTo>
<awsl:TransactionFlowLink>
<awsl:Consumer>
<awsl:UniqueID>8cf7f048-1eff-457f-8388-bb8294b3999b</awsl:UniqueID>
</awsl:Consumer>
<awsl:Receiver>
<awsl:ServerID>urn:uuid:817dcf79-5c01-5ebf-8335-a1690266b138</awsl:ServerID>
</awsl:Receiver>
</awsl:TransactionFlowLink>
<awsse:Session TransactionStatusCode="End">
<awsse:SessionId>00RQN0DLR6</awsse:SessionId>
<awsse:SequenceNumber>1</awsse:SequenceNumber>
<awsse:SecurityToken>2UHR8Z2844ME02AYL2AOL5K4YK</awsse:SecurityToken>
</awsse:Session>
</soap:Header>
<soap:Body>
<Fare_GetFareFamilyDescriptionReply xmlns="http://xml.amadeus.com/TFQFRR_15_1_1A">
<fareFamilyDescriptionGroup>
<referenceInformation>
<itemNumberDetails>
<number>1</number>
</itemNumberDetails>
</referenceInformation>
.
.
.
</freeTextDetails>
<freeText>ALL SERVICES MAY NOT BE DELIVERED AS THE REQUESTED FARE COMPONENT MAY INCLUDE A CODESHARE FLIGHT OR AN INTERLINE ITINERARY</freeText>
</errorWarningDescription>
</errorInformationFareFamily>
</fareFamilyDescriptionGroup>
</Fare_GetFareFamilyDescriptionReply>
</soap:Body>
</soap:Envelope>Click here to view the full code
