• Mail us
  • Book a Meeting
  • Call us
  • Chat with us

GDS

Comprehensive Guide to Amadeus Enterprise API for Flight Search: Fare_MasterPricerTravelBoardSearch

We utilize cookies that are essential for providing responses. By continuing to engage with our Center of Excellence topic, you consent to our use of cookies.


Introduction

The Amadeus Enterprise API provides a powerful suite of tools for travel agencies, airlines, and other travel-related businesses to access real-time flight pricing, availability, and booking options. One of its most widely used features is the Fare_MasterPricerTravelBoardSearch API, which enables comprehensive flight search capabilities with extensive filtering and customization options.

This article provides an in depth look at the Fare_MasterPricerTravelBoardSearch API, covering its key features, request structure, response format, use cases and best practices for integration.

What is Fare_MasterPricerTravelBoardSearch?

The Fare_MasterPricerTravelBoardSearch API is part of the Amadeus Enterprise Flight Search API suite. It allows users to:

  • Search for flight itineraries based on origin, destination, dates and travel preferences.
  • Retrieve real-time pricing, availability and fare rules.
  • Apply filters (e.g., airlines, cabin class, pricing options).
  • Access both published and private fares (if authorized).
  • Retrieve multi leg trip options (round trip, one way, open jaw).

This API is ideal for:

  • Online Travel Agencies (OTAs)
  • Corporate travel management systems
  • Airline booking engines
  • Meta-search platforms

Key Features

2.1. Comprehensive Flight Search

  • Supports one-way, round trip, and multi city itineraries.
  • Retrieves published fares, negotiated fares and loyalty fares (if applicable).
  • Provides best price options with multiple airline combinations.

2.2. Advanced Filtering Options

  • Airlines: Filter by specific carriers.
  • Cabin Class: Economy, Premium Economy, Business, First.
  • Flight Duration: Set maximum connection times.
  • Pricing Options: Flexible date searches, refundable/non-refundable fares.
  • Stopovers: Direct flights only or allow connections.

2.3. Real-Time Availability & Pricing

  • Returns up to date seat availability.
  • Includes fare breakdown (base fare, taxes, fees).
  • Supports dynamic pricing adjustments.

2.4. Multi-Leg & Complex Itineraries

  • Handles open-jaw trips (different departure/return cities).
  • Supports multi-destination searches (e.g., city-hopping trips).

API Request Structure

The Fare_MasterPricerTravelBoardSearch request is structured in XML or JSON format. Below is a breakdown of key request parameters:

3.1. Basic Search Parameters


1<Fare_MasterPricerTravelBoardSearch>
2    <numberOfUnit>
3        <unitNumberDetail>
4            <typeOfUnit>PX</typeOfUnit>  <!-- Passenger count -->
5            <units>1</units>             <!-- 1 passenger -->
6        </unitNumberDetail>
7    </numberOfUnit>
8    <pricingTicketing>
9        <priceType>ET</priceType>        <!-- Electronic Ticket -->
10    </pricingTicketing>
11    <travelFlightInfo>
12        <cabinId>
13            <cabin>Y</cabin>             <!-- Economy Class -->
14        </cabinId>
15    </travelFlightInfo>
16    <itinerary>
17        <requestedSegmentRef>
18            <segRef>1</segRef>
19        </requestedSegmentRef>
20        <departureLocalization>
21            <departurePoint>
22                <locationId>JFK</locationId>  <!-- Origin: JFK -->
23            </departurePoint>
24            <arrivalPoint>
25                <locationId>LAX</locationId>  <!-- Destination: LAX -->
26            </arrivalPoint>
27            <departureDate>2025-05-20</departureDate>
28        </departureLocalization>
29    </itinerary>
30</Fare_MasterPricerTravelBoardSearch>

3.2. Advanced Filters

Airline Preferences:

1<airlineOptions>
2    <carrier>
3        <airlineCode>DL</airlineCode>  <!-- Delta Airlines -->
4    </carrier>
5</airlineOptions>


Max Connections:

1<flightInfo>
2    <connections maxNumber="1"/>  <!-- Max 1 stopover -->
3</flightInfo>


Flexible Dates:

1<timeDetails>
2    <firstDateTime>2025-05-20</firstDateTime>
3    <rangeOfDate>3</rangeOfDate>  <!-- +/- 3 days flexibility -->
4</timeDetails>
5

API Response Structure

The response includes flight options with pricing, availability and fare conditions. Example response snippet:

1<flightIndex>
2    <groupOfFlights>
3        <flightDetails>
4            <flightInformation>
5                <flightDate>
6                    <departureDate>2025-05-20</departureDate>
7                    <departureTime>08:15</departureTime>
8                </flightDate>
9                <boardPointDetails>
10                    <trueLocationId>JFK</trueLocationId>
11                </boardPointDetails>
12                <offPointDetails>
13                    <trueLocationId>LAX</trueLocationId>
14                </offPointDetails>
15                <companyDetails>
16                    <marketingCompany>DL</marketingCompany>
17                </companyDetails>
18                <flightIdentification>
19                    <flightNumber>123</flightNumber>
20                </flightIdentification>
21            </flightInformation>
22        </flightDetails>
23        <priceDetails>
24            <totalAmount>299.00</totalAmount>
25            <currency>USD</currency>
26            <fareBasis>Y</fareBasis>
27        </priceDetails>
28    </groupOfFlights>
29</flightIndex>
30

Key Response Fields:

  • Flight Details: Departure/arrival times, airline and flight number.
  • Pricing: Total fare, taxes, currency.
  • Availability: Seat count, booking class.
  • Fare Rules: Refundability, change fees.

Use Cases

5.1. Online Travel Agencies (OTAs)

  • Display real time flight options with competitive pricing.
  • Allow filtering by price, duration and airline.

5.2. Corporate Travel Management

  • Access negotiated corporate fares.
  • Enforce travel policies (e.g., preferred airlines, max stops).

5.3. Airline & Loyalty Programs

  • Retrieve personalized fares for frequent flyers.
  • Offer dynamic pricing based on loyalty tiers.

Best Practices for Integration

  1. Use Pagination: For large result sets, implement pagination.
  2. Cache Frequent Queries: Reduce API calls by caching common searches.
  3. Error Handling: Manage API rate limits and timeouts gracefully.
  4. Test in Sandbox: Use Amadeus test environment before going live.
  5. Optimize Requests: Minimize unnecessary filters to improve response time.

Conclusion

The Amadeus Fare_MasterPricerTravelBoardSearch API is a robust solution for flight search and pricing, offering flexibility, real time data and advanced filtering. By leveraging this API, travel businesses can enhance their booking engines, improve customer experience and stay competitive in the dynamic travel industry.

For detailed API documentation, visit Amadeus Developer Portal.


Next Steps

  • Sign up for an Amadeus API key.
  • Explore the sandbox environment for testing.
  • Implement the API in your travel application.

Would you like to do implementation in a specific programming language (e.g., Python, Node, Laravel)?

Supercharge Your Travel Operations with Seamless Tech, Don’t Wait - Contact Us Today and Let’s Make It Happen!

0