Premium Flex Search Guide
This guide is specific to Premium Flex Search functionality. The Air Search Guide contains general information about search requests and responses.
In this guide:
- Endpoint
- Options
- Scope and support (including warning messages)
- Aggregated and streamed responses
- Flex search point of sale
- Flex search dates
- Flex search origin and destination
- Flex search airport distance (radius)
Premium Flex Search Endpoint
When sending flex search requests, append /premiumflex to the existing Search API endpoint.
Premium Flex Search Options
Premium Flex Search provides flexibility around search dates
-
Premium Flex Search Point of Sale (POS): In the Search request, send PricingModifiersAir/MultiPricingAgency with up to three PCCs to search in addition to the provisioned PCC. PCCs must be a branch agency provisioned with access for the requested PCC. The flex search options sent in Search carry over to any subsequent Next Leg Search request.
-
Premium Flex Search Dates: In the Search request, send SearchCriteriaFlight/daysBeforeDeparture and/or /daysAfterDeparture with the value/s 1, 2, or 3 to search up to that number of days before and/or after the departure date. The flex search options sent in Search carry over to any subsequent Next Leg Search and Flight Specific Search reference payload request.
-
Premium Flex Search Origin and Destination: In the Search request, send SearchCriteriaFlight/AdditionalFrom and/or AdditionalTo with up to two additional departure and arrival locations. The flex search options sent in Search carry over to any subsequent Next Leg Search request.
-
Premium Flex Search Airport Distance (radius): In the Search request, send radius and radiusMeasurement in the SearchCriteriaFlight/From and/or To objects to search for alternate airports within a specific distance. The maximum distance allowed is 100 miles or 160 kilometers. Up to 4 alternate commercial airports within the specified distance can be returned.
Scope and support
-
GDS only, not supported for NDC.
-
Not supported for split ticketing or sorting.
-
Only one flex search capability can be sent in a request.
-
Supported in the Search API for journey- and leg-based searches for one and two O&Ds; three or more O&Ds are out of scope.
-
Any flex options sent in the Search request carry over to any subsequent Next Leg Search and Flight Specific Search reference payload requests.
-
Flight Specific Search supports Flex Search POS for both the reference and full payload. Neither payload supports Flex Search Dates.
Flex Search warning messages
-
If not authorized for Premium Flex Search Origin/Destination, the warning “USER MUST BE AUTHORIZED FOR PREMIUM FLEX SEARCH. PLEASE CONTACT SUPPORT” is returned.
-
If content source NDC only or NDC+GDS is sent, the warning “PREMIUM FLEX SEARCH IS NOT SUPPORTED FOR CONTENT SOURCE REQUESTED AND HAS BEEN IGNORED” is returned.
-
If 3 or more Origin/Destinations are sent, the warning “PREMIUM FLEX SEARCH IS NOT SUPPORTED FOR JOURNEYS WITH MORE THAN TWO ORIGINS/DESTINATIONS AND HAS BEEN IGNORED” is returned.
-
If more than one Flex Search option (Flex POS + Flex Origin/Destination) is sent, the warning “PREMIUM FLEX SEARCH OPTIONS CANNOT BE COMBINED AND HAVE BEEN IGNORED” is returned.
-
If sorting is requested, the warning “SORT BY CANNOT BE REQUESTED IN CONJUNCTION WITH PREMIUM FLEX SEARCH AND HAS BEEN IGNORED” is returned.
-
When more than 2 additional city/airport codes in AdditionalFrom and/or AdditionalTo are sent, the warning “MAXIMUM NUMBER OF PREMIUM FLEX SEARCH ADDITIONAL FROM/TO HAS BEEN EXCEEDED” is returned.
-
When a reference based Flight Specific Search request is sent after a successful Premium Flex Search Origin/Destination response, the error PREMIUM FLEX SEARCH OPTION REQUESTED IS NOT SUPPORTED is returned.
-
If a customer sends radius without radiusMeasurement or vice versa, the warning “RADIUS AND RADIUS MEASUREMENT MUST BE SENT IN PREMIUM FLEX SEARCH AIRPORT DISTANCE” is returned.
-
If a customer sends a radius that is greater than 100 Miles and 160 Kilometers, the warning “MAXIMUM MILES/KILOMETERS IN PREMIUM FLEX SEARCH RADIUS HAS BEEN EXCEEDED' is returned.
Aggregated and Streamed Responses
The Accept header value controls the format of the response; see Common Headers for details:
-
for aggregated content (all offers are combined into a single CatalogProductOfferingsResponse object), send with the value application/json
-
for streamed content (multiple CatalogProductOfferingsResponse objects are returned consecutively) send with the value application/stream+json
Numbering Formats in References for Aggregated Content
For aggregated content for
- offer ids: f1o1, f1o2, and so on in the first offer, f2o1, f2o2 and so on in the second offer, etc.
- CombinabilityCode: f1j0, f1j1 and so on in the first offer, f2j0, f2j1, and so on in the second offer.
- ProductRef: f1p0, f1p1, and so on in the first offer, f2p0, f2p1, and so on in the second offer.
- BrandRef: f1b0, f1b1, and so on in the first offer, f2b0, f2b1 and so on in the second offer.
- flightRef: f1s1, f1s2, and so on in the first offer, f2s1, f2s2, and so on in the second offer.
- TermsAndConditionsRef: f1T0, f1T1, and so on in the first offer, f2T0, f2T1,and so on in for the second offer.
Do not assume that CatalogProductOffering/id values follow a sequential pattern (e.g., f1, f2, f3) in aggregated flex search responses. Implementations must not rely on this ordering when consuming the data.
For streamed content for both flex POS and dates, offers are separated into individual CatalogProductOfferingsResponse objects. Each CatalogProductOfferingsResponse contains offers for only one PCC or one date, so the fx numbering format is not used in streamed content.
Flex Search Point of Sale (POS)
Flex Search Point of Sale (POS) allows you to expand your offer options for customers based on the point of sale of your branch agencies. The response returns offers in geographic locations for up to three PCCs Pseudo city code. A travel provider's identification code for the APIs, provisioned from Travelport. Used to determine access and other settings in the APIs for your company. sent in PricingModifiersAir/MultiPricingAgency.
-
If more than 3 PCCs are sent in MultiPricingAgency, only the first 3 are validated, and the warning “MAXIMUM NUMBER OF PREMIUM FLEX SEARCH MULTI PRICING AGENCIES HAS BEEN EXCEEDED” is returned.
-
If a both PricingPCC and MultiPricingAgency are sent with PCCs, the PCC in PricingPCC is ignored, and the warning “PREMIUM FLEX SEARCH MULTI PRICING AGENCY CANNOT BE COMBINED WITH PRICING PCC” is returned.
In the response, each offer returns its corresponding PCC in ReferenceListTermsAndConditions/TermsAndConditions @TermsAndConditionsAir/Pricing Agency.
Show Example Flex Search Point of Sale (PCC) request
{
"CatalogProductOfferingsQueryRequest": {
"CatalogProductOfferingsRequest": {
"@type": "CatalogProductOfferingsRequestAir",
"contentSourceList": [
"GDS"
],
"maxNumberOfUpsellsToReturn": 0,
"PassengerCriteria": [
{
"@type": "PassengerCriteria",
"number": 1,
"passengerTypeCode": "ADT"
},
{
"@type": "PassengerCriteria",
"number": 1,
"passengerTypeCode": "CHD"
}
],
"SearchCriteriaFlight": [
{
"@type": "SearchCriteriaFlight",
"departureDate": "2026-04-15",
"From": {
"value": "MOW"
},
"To": {
"value": "DXB"
}
}
],
"PricingModifiersAir": {
"@type": "PricingModifiersAir",
"fareSelection": {
"@type": "FareSelectionDetail",
"fareType": "PrivateFaresOnly"
},
"MultiPricingAgency": [
"DU7",
"EA9"
]
},
"CustomResponseModifiersAir": {
"SearchRepresentation": "Journey",
"includeFareCalculationInd": false
}
}
}
}The following example shows the high-level structure of a streamed response to a flex POS request. All major objects except for instance of CatalogProductOffering have been replaced with ... to emphasize the overall structure of returning multiple CatalogProductOfferingsResponse objects. For the one offer shown below, the corresponding ReferenceListTermsAndConditions returns PricingAgency with the PCC for that offer.
Show Example flex POS response - streamed
{
"CatalogProductOfferingsResponse": {
"@type": "CatalogProductOfferingsResponse",
"transactionId": "flex01_ef8610048c354e250dcc911d46c5e80f",
"traceId": "TraceID|dl*",
"CatalogProductOfferings": {
"@type": "CatalogProductOfferings",
"CatalogProductOffering": [
{...},
{...}
]
},
"Result": {...},
"ReferenceList": [...]
}
}{
"CatalogProductOfferingsResponse": {
"@type": "CatalogProductOfferingsResponse",
"transactionId": "flex00_ef8610048c354e250dcc911d46c5e80f",
"traceId": "TraceID|dl*",
"CatalogProductOfferings": {
"@type": "CatalogProductOfferings",
"CatalogProductOffering": [
{...},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "o2",
"Departure": "DME",
"Arrival": "DXB",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "b0"
}
],
"ProductBrandOptions": [
{
"@type": "ProductBrandOptions",
"flightRefs": [
"s1",
"s2"
],
"ProductBrandOffering": [
{
"@type": "ProductBrandOffering",
"Brand": {
"@type": "BrandID",
"BrandRef": "b0"
},
"Product": [
{
"@type": "ProductID",
"productRef": "p1"
}
],
"TermsAndConditions": {
"@type": "TermsAndConditionsID",
"termsAndConditionsRef": "T1"
},
"CombinabilityCode": [
"j2"
],
"BestCombinablePrice": {...},
"ContentSource": "GDS"
}
]
},
{...}
]
}
]
},
"Result": {
"@type": "Result"
},
"ReferenceList": [
{
"@type": "ReferenceListFlight",
"Flight": [...]
},
{
"@type": "ReferenceListProduct",
"Product": [...]
},
{
"@type": "ReferenceListBrand",
"Brand": [...]
},
{
"@type": "ReferenceListTermsAndConditions",
"TermsAndConditions": [
{
"@type": "TermsAndConditionsAir",
"id": "T1",
"BaggageAllowance": [...],
"ValidatingAirline": [...],
"TicketingAgency": [...],
"PaymentTimeLimit": "2026-04-15T23:59:00Z",
"Penalties": [...],
"TourCodes": [...],
"PricingAgency": [
{
"@type": "PricingAgency",
"Code": "DU7"
}
]
},
{...}
]
}
]
}
}Flex Search Dates
Flex Search Dates allows you to return offers for a range of dates around the specified departure date. In the request, in either or both daysBeforeDeparture and/or daysAfterDeparture in each instance of SearchCriteriaFlight, send the value 1, 2, or 3 to specify that many days to search before and/or after the date in departureDate.
When a customer sends a reference based Flight Specific Search request after a successful Premium Flex Search Origin/Destination response, the error PREMIUM FLEX SEARCH OPTION REQUESTED IS NOT SUPPORTED is returned.
When departureDate and arrivateDate are in the request, departureDate is validated and arrivalDate is ignored. If only the arrivalDate is sent, the request acts like a normal search and does not return flex search options in the response. A warning is returned.
Show Example Flex Search Dates request
{
"CatalogProductOfferingsQueryRequest": {
"CatalogProductOfferingsRequest": {
"@type": "CatalogProductOfferingsRequestAir",
"contentSourceList": [
"GDS"
],
"maxNumberOfUpsellsToReturn": 4,
"PassengerCriteria": [
{
"number": 1,
"passengerTypeCode": "ADT"
}
],
"SearchCriteriaFlight": [
{
"departureDate": "2026-02-09",
"daysBeforeDeparture": 1,
"daysAfterDeparture": 2,
"From": {
"value": "PEN"
},
"To": {
"value": "MEL"
}
},
{
"departureDate": "2026-02-18",
"daysBeforeDeparture": 2,
"daysAfterDeparture": 1,
"From": {
"value": "MEL"
},
"To": {
"value": "PEN"
}
}
]
}
}
}The following example shows an aggregated response to a flex search dates request. For brevity, only two offers are shown, and the Result and ReferenceList objects have been replaced with ... to show the overall structure. For aggregated content for a leg-based search, per below, each offer returns FlexNextLeg to identify the return date of the product (the next leg) that is combinable with the outbound product at the price and terms and conditions in that offer.
Show Example flex dates response - aggregated
{
"CatalogProductOfferingsResponse": {
"@type": "CatalogProductOfferingsResponse",
"transactionId": "d35b3ec7-37ae-412c-aef3-023900cff67b",
"CatalogProductOfferings": {
"@type": "CatalogProductOfferings",
"Identifier": {
"value": "20586926-b2da-4cfa-9672-877a05378d8b"
},
"CatalogProductOffering": [
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f1o1",
"Departure": "NRT",
"Arrival": "BKK",
"FlexNextLeg": [
{
"@type": "FlexNextLeg",
"departureDate": "2026-03-27"
}
],
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f1b0"
},
{
"@type": "BrandID",
"BrandRef": "f1b1"
}
],
"ProductBrandOptions": [
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f1s18"
],
"ProductBrandOffering": [
{
"@type": "ProductBrandOffering",
"Brand": {
"@type": "BrandID",
"BrandRef": "f1b0"
},
"Product": [
{
"@type": "ProductID",
"productRef": "f1p0"
}
],
"TermsAndConditions": {
"@type": "TermsAndConditionsID",
"termsAndConditionsRef": "f1T0"
},
"CombinabilityCode": [
"f1j1"
],
"BestCombinablePrice": {
"@type": "BestCombinablePriceDetail",
"CurrencyCode": {
"decimalPlace": 0,
"value": "RUB"
},
"Base": 20450,
"TotalTaxes": 8978,
"TotalFees": 0,
"TotalPrice": 29428,
"PriceBreakdown": [
{
"@type": "PriceBreakdownAir",
"quantity": 1,
"requestedPassengerType": "ADT",
"Amount": {
"@type": "Amount",
"CurrencyCode": {
"decimalPlace": 0,
"value": "RUB"
},
"Base": 20450,
"Taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 8978,
"Tax": [...]
},
"Fees": {
"@type": "FeesDetail",
"TotalFees": 0
},
"Total": 29428
}
}
]
},
"ContentSource": "GDS"
},
{
"@type": "ProductBrandOffering",
"Brand": {
"@type": "BrandID",
"BrandRef": "f1b1"
},
"Product": [
{
"@type": "ProductID",
"productRef": "f1p1"
}
],
"TermsAndConditions": {
"@type": "TermsAndConditionsID",
"termsAndConditionsRef": "f1T1"
},
"CombinabilityCode": [
"f1j2"
],
"BestCombinablePrice": {
"@type": "BestCombinablePriceDetail",
"CurrencyCode": {
"decimalPlace": 0,
"value": "RUB"
},
"Base": 132865,
"TotalTaxes": 8978,
"TotalFees": 0,
"TotalPrice": 141843,
"PriceBreakdown": [
{
"@type": "PriceBreakdownAir",
"quantity": 1,
"requestedPassengerType": "ADT",
"Amount": {
"@type": "Amount",
"CurrencyCode": {
"decimalPlace": 0,
"value": "RUB"
},
"Base": 132865,
"Taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 8978,
"Tax": [...]
},
"Fees": {
"@type": "FeesDetail",
"TotalFees": 0
},
"Total": 141843
}
}
]
},
"ContentSource": "GDS"
}
]
}
]
},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f1o3",
"Departure": "NRT",
"Arrival": "BKK",
"FlexNextLeg": [
{
"@type": "FlexNextLeg",
"departureDate": "2026-03-27"
}
],
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f1b2"
},
{
"@type": "BrandID",
"BrandRef": "f1b3"
},
{
"@type": "BrandID",
"BrandRef": "f1b4"
},
{
"@type": "BrandID",
"BrandRef": "f1b5"
},
{
"@type": "BrandID",
"BrandRef": "f1b6"
},
{
"@type": "BrandID",
"BrandRef": "f1b7"
},
{
"@type": "BrandID",
"BrandRef": "f1b8"
},
{
"@type": "BrandID",
"BrandRef": "f1b9"
},
{
"@type": "BrandID",
"BrandRef": "f1b10"
},
{
"@type": "BrandID",
"BrandRef": "f1b11"
},
{
"@type": "BrandID",
"BrandRef": "f1b12"
},
{
"@type": "BrandID",
"BrandRef": "f1b13"
},
{
"@type": "BrandID",
"BrandRef": "f1b14"
},
{
"@type": "BrandID",
"BrandRef": "f1b15"
},
{
"@type": "BrandID",
"BrandRef": "f1b16"
},
{
"@type": "BrandID",
"BrandRef": "f1b17"
},
{
"@type": "BrandID",
"BrandRef": "f1b18"
},
{
"@type": "BrandID",
"BrandRef": "f1b19"
},
{
"@type": "BrandID",
"BrandRef": "f1b20"
},
{
"@type": "BrandID",
"BrandRef": "f1b21"
},
{
"@type": "BrandID",
"BrandRef": "f1b22"
}
],
"ProductBrandOptions": [
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f1s19"
],
"ProductBrandOffering": [
{
"@type": "ProductBrandOffering",
"Brand": {
"@type": "BrandID",
"BrandRef": "f1b2"
},
"Product": [
{
"@type": "ProductID",
"productRef": "f1p4"
}
],
"TermsAndConditions": {
"@type": "TermsAndConditionsID",
"termsAndConditionsRef": "f1T4"
},
"CombinabilityCode": [
"f1j3"
],
"BestCombinablePrice": {
"@type": "BestCombinablePriceDetail",
"CurrencyCode": {
"decimalPlace": 0,
"value": "RUB"
},
"Base": 23040,
"TotalTaxes": 8338,
"TotalFees": 0,
"TotalPrice": 31378,
"PriceBreakdown": [
{
"@type": "PriceBreakdownAir",
"quantity": 1,
"requestedPassengerType": "ADT",
"Amount": {
"@type": "Amount",
"CurrencyCode": {
"decimalPlace": 0,
"value": "RUB"
},
"Base": 23040,
"Taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 8338,
"Tax": [...]
},
"Fees": {
"@type": "FeesDetail",
"TotalFees": 0
},
"Total": 31378
}
}
]
},
"ContentSource": "GDS"
}
]
}
]
}]
},
"Result": {...},
"ReferenceList": [...]
}
}
Flex Search Origin and Destination
Flex Search Origin and Destination allows you to include additional departure and/or arrival locations in Search. Send SearchCriteriaFlight/AdditionalFrom and/or AdditionalTo with up to two additional departure and arrival locations.
In this example, the From airport is JFK, and BOS and EWR are included as additional departure airports. The To airport is MIA, and FFL and LGB are included as additional arrival airports.
Show Example Flex Search Origin and Destination request
{
"CatalogProductOfferingsQueryRequest": {
"CatalogProductOfferingsRequest": {
"@type": "CatalogProductOfferingsRequestAir",
"contentSourceList": [
"GDS"
],
"maxNumberOfUpsellsToReturn": 4,
"offersPerPage": 20,
"PassengerCriteria": [
{
"number": 1,
"passengerTypeCode": "ADT"
}
],
"SearchCriteriaFlight": [
{
"departureDate": "2026-07-22",
"From": {
"value": "JFK",
"cityOrAirport": "Airport Only"
},
"To": {
"value": "MIA",
"cityOrAirport": "Airport Only"
},
"AdditionalFrom": [
{
"value": "BOS",
"cityOrAirport": "Airport Only"
},
{
"value": "EWR",
"cityOrAirport": "Airport Only"
}
],
"AdditionalTo": [
{
"value": "FLL",
"cityOrAirport": "Airport Only"
},
{
"value": "LGB",
"cityOrAirport": "Airport Only"
}
]
}
]
}
}
}
For the leg-based Premium Flex Search Origin/Destination response, where the offers/products of the first and additional departure and arrival locations are returned, FlexNextLeg Departure and Arrival airport are returned under each CatalogProductOffering. This identifies the departure and arrival airport of the offer/product that is combinable with the outbound offer/product.
The following example shows an aggregated response to a flex search origin and destination request, which means that all offers are combined into a single CatalogProductOfferingsResponse object. For brevity, only the first offer is shown completely, and other options, the Result, and ReferenceList objects have been replaced with ... to show the overall structure.
Show Example Flex Search Origin and Departure response
{
"CatalogProductOfferingsResponse": {
"@type": "CatalogProductOfferingsResponse",
"transactionId": "c1dea3b465e341484e453226fbe8c49f",
"CatalogProductOfferings": {
"@type": "CatalogProductOfferings",
"Identifier": {
"value": "ea370fe9-ba58-46b6-8214-ddebc0ff3099"
},
"CatalogProductOffering": [
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f1o1",
"Departure": "JFK",
"Arrival": "MIA",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f1b0"
},
{
"@type": "BrandID",
"BrandRef": "f1b1"
},
{
"@type": "BrandID",
"BrandRef": "f1b2"
},
{
"@type": "BrandID",
"BrandRef": "f1b3"
},
{
"@type": "BrandID",
"BrandRef": "f1b4"
}
],
"ProductBrandOptions": [
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f1s2"
],
"ProductBrandOffering": [
{
"@type": "ProductBrandOffering",
"Brand": {
"@type": "BrandID",
"BrandRef": "f1b0"
},
"Product": [
{
"@type": "ProductID",
"productRef": "f1p0"
}
],
"TermsAndConditions": {
"@type": "TermsAndConditionsID",
"termsAndConditionsRef": "f1T0"
},
"CombinabilityCode": [
"f1j1"
],
"BestCombinablePrice": {
"@type": "BestCombinablePriceDetail",
"CurrencyCode": {
"decimalPlace": 2,
"value": "AUD"
},
"Base": 135,
"TotalTaxes": 32,
"TotalFees": 0,
"TotalPrice": 167,
"PriceBreakdown": [
{
"@type": "PriceBreakdownAir",
"quantity": 1,
"requestedPassengerType": "ADT",
"Amount": {
"@type": "Amount",
"CurrencyCode": {
"decimalPlace": 2,
"value": "AUD"
},
"Base": 135,
"Taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 32,
"Tax": [
{
"taxCode": "AY",
"value": 7.9
},
{
"taxCode": "US",
"value": 10.2
},
{
"taxCode": "XF",
"value": 6.4
},
{
"taxCode": "ZP",
"value": 7.5
}
]
},
"Fees": {
"@type": "FeesDetail",
"TotalFees": 0
},
"Total": 167
}
}
]
},
"ContentSource": "GDS"
},
{
"@type": "ProductBrandOffering",
"Brand": {
"@type": "BrandID",
"BrandRef": "f1b1"
},
"Product": [
{
"@type": "ProductID",
"productRef": "f1p4"
}
],
"TermsAndConditions": {
"@type": "TermsAndConditionsID",
"termsAndConditionsRef": "f1T1"
},
"CombinabilityCode": [
"f1j2"
],
"BestCombinablePrice": {
"@type": "BestCombinablePriceDetail",
"CurrencyCode": {
"decimalPlace": 2,
"value": "AUD"
},
"Base": 194,
"TotalTaxes": 36.4,
"TotalFees": 0,
"TotalPrice": 230.4,
"PriceBreakdown": [
{
"@type": "PriceBreakdownAir",
"quantity": 1,
"requestedPassengerType": "ADT",
"Amount": {
"@type": "Amount",
"CurrencyCode": {
"decimalPlace": 2,
"value": "AUD"
},
"Base": 194,
"Taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 36.4,
"Tax": [
{
"taxCode": "AY",
"value": 7.9
},
{
"taxCode": "US",
"value": 14.6
},
{
"taxCode": "XF",
"value": 6.4
},
{
"taxCode": "ZP",
"value": 7.5
}
]
},
"Fees": {
"@type": "FeesDetail",
"TotalFees": 0
},
"Total": 230.4
}
}
]
},
"ContentSource": "GDS"
},
{
"@type": "ProductBrandOffering",
"Brand": {
"@type": "BrandID",
"BrandRef": "f1b2"
},
"Product": [
{
"@type": "ProductID",
"productRef": "f1p8"
}
],
"TermsAndConditions": {
"@type": "TermsAndConditionsID",
"termsAndConditionsRef": "f1T2"
},
"CombinabilityCode": [
"f1j3"
],
"BestCombinablePrice": {
"@type": "BestCombinablePriceDetail",
"CurrencyCode": {
"decimalPlace": 2,
"value": "AUD"
},
"Base": 259,
"TotalTaxes": 41.3,
"TotalFees": 0,
"TotalPrice": 300.3,
"PriceBreakdown": [
{
"@type": "PriceBreakdownAir",
"quantity": 1,
"requestedPassengerType": "ADT",
"Amount": {
"@type": "Amount",
"CurrencyCode": {
"decimalPlace": 2,
"value": "AUD"
},
"Base": 259,
"Taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 41.3,
"Tax": [
{
"taxCode": "AY",
"value": 7.9
},
{
"taxCode": "US",
"value": 19.5
},
{
"taxCode": "XF",
"value": 6.4
},
{
"taxCode": "ZP",
"value": 7.5
}
]
},
"Fees": {
"@type": "FeesDetail",
"TotalFees": 0
},
"Total": 300.3
}
}
]
},
"ContentSource": "GDS"
},
[...]
]
}
]
},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f1o2",
"Departure": "JFK",
"Arrival": "MIA",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f1b0"
},
{
"@type": "BrandID",
"BrandRef": "f1b1"
},
{
"@type": "BrandID",
"BrandRef": "f1b2"
},
{
"@type": "BrandID",
"BrandRef": "f1b3"
},
{
"@type": "BrandID",
"BrandRef": "f1b4"
}
],
[...]
},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f2o1",
"Departure": "JFK",
"Arrival": "FLL",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f2b0"
},
{
"@type": "BrandID",
"BrandRef": "f2b1"
},
{
"@type": "BrandID",
"BrandRef": "f2b2"
},
{
"@type": "BrandID",
"BrandRef": "f2b3"
},
{
"@type": "BrandID",
"BrandRef": "f2b4"
}
],
[...]
},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f2o2",
"Departure": "JFK",
"Arrival": "FLL",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f2b0"
},
{
"@type": "BrandID",
"BrandRef": "f2b1"
},
{
"@type": "BrandID",
"BrandRef": "f2b2"
},
{
"@type": "BrandID",
"BrandRef": "f2b3"
},
{
"@type": "BrandID",
"BrandRef": "f2b4"
}
],
[...]
},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f3o1",
"Departure": "JFK",
"Arrival": "LGB",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f3b0"
},
{
"@type": "BrandID",
"BrandRef": "f3b1"
},
{
"@type": "BrandID",
"BrandRef": "f3b2"
},
{
"@type": "BrandID",
"BrandRef": "f3b3"
},
{
"@type": "BrandID",
"BrandRef": "f3b4"
},
{
"@type": "BrandID",
"BrandRef": "f3b5"
}
],
[...]
},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f4o1",
"Departure": "BOS",
"Arrival": "MIA",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f4b0"
},
{
"@type": "BrandID",
"BrandRef": "f4b1"
},
{
"@type": "BrandID",
"BrandRef": "f4b2"
},
{
"@type": "BrandID",
"BrandRef": "f4b3"
},
{
"@type": "BrandID",
"BrandRef": "f4b4"
}
],
},
[...]
]
},
"Result": {
"@type": "Result"
},
"ReferenceList": [ ... ]
Flex Search Airport Distance
Flex Search Airport Distance allows you to search for offers from alternate airports that are within the specified distance from the origin and/or destination airport. To search by airport distance, send radius and radiusMeasurement in the SearchCriteriaFlight/From and/or To objects. The maximum distance allowed is 100 miles or 160 kilometers. Up to 4 alternate commercial airports within the specified distance can be returned.
When using Flex Search Airport Distance, it is recommended that you specify airport codes in the From and To fields and that you also set "cityOrAirport": "Airport Only". If a city code is provided instead, and that city is served by multiple airports, the search response may return duplicate offers and products.
For the leg-based Flex Search Airport Distance response, where the offers/products of the first and additional departure and arrival locations are returned, FlexNextLeg Departure and Arrival airport are returned under each CatalogProductOffering. This indicates the departure and arrival airport of the offer/product that is combinable with the outbound offer/product.
The following example requests offers from OGG and airports within a 25-mile radius of OGG to LAX. Both the From and To locations are set to “Airport Only”.
Show Example Flex Search Airport Distance request
{
"CatalogProductOfferingsQueryRequest": {
"CatalogProductOfferingsRequest": {
"@type": "CatalogProductOfferingsRequestAir",
"contentSourceList": [
"GDS"
],
"maxNumberOfUpsellsToReturn": 0,
"offersPerPage": 3,
"PassengerCriteria": [
{
"number": 1,
"passengerTypeCode": "ADT"
}
],
"SearchCriteriaFlight": [
{
"@type": "SearchCriteriaFlight",
"departureDate": "2026-10-10",
"From": {
"value": "OGG",
"cityOrAirport": "Airport Only",
"radius": 25,
"radiusMeasurement": "Miles"
},
"To": {
"value": "LAX",
"cityOrAirport": "Airport Only"
}
}
],
"CustomResponseModifiersAir": {
"@type": "CustomResponseModifiersAir",
"SearchRepresentation": "Journey"
}
}
}
}In the Search response, the CatalogProductOffering with “id” that starts with “f1” returns offers from OGG (Kahului airport on Maui) to LAX. The CatalogProductOferring with “id” that starts with “f2” return offers from JHM (Kapalua airport on Maui) to LAX. For brevity, only two offers from each departure airport are shown; details from other sections have been replaced with ... to show the overall structure.
Show Example Flex Search Airport Distance response
{
"CatalogProductOfferingsResponse": {
"@type": "CatalogProductOfferingsResponse",
"transactionId": "PricingPCC3",
"CatalogProductOfferings": {
"@type": "CatalogProductOfferings",
"Identifier": {
"value": "c266bd0b-92a7-470d-ae80-81131e99bfcf"
},
"CatalogProductOffering": [
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f1o1",
"Departure": "OGG",
"Arrival": "LAX",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f1b0"
}
],
"ProductBrandOptions": [
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f1s1"
],
...
},
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f1s2"
],
...
},
"ContentSource": "GDS"
}
]
}
]
},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f1o2",
"Departure": "OGG",
"Arrival": "LAX",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f1b1"
}
],
"ProductBrandOptions": [
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f1s4"
],
...
},
"ContentSource": "GDS"
}
]
}
]
},
...
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f2o1",
"Departure": "JHM",
"Arrival": "LAX",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f2b1"
}
],
"ProductBrandOptions": [
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f2s3",
"f2s4"
],
...
},
"ContentSource": "GDS"
}
]
},
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f2s8",
"f2s9"
],
...
},
"ContentSource": "GDS"
}
]
}
]
},
{
"@type": "CatalogProductOffering",
"sequence": 1,
"id": "f2o2",
"Departure": "JHM",
"Arrival": "LAX",
"Brand": [
{
"@type": "BrandID",
"BrandRef": "f2b2"
}
],
"ProductBrandOptions": [
{
"@type": "ProductBrandOptions",
"flightRefs": [
"f2s5",
"f2s6",
"f2s7"
],
...
},
"ContentSource": "GDS"
}
]
}
]
},
...
]
},
"Result": {
"@type": "Result"
},
"ReferenceList": [
{
"@type": "ReferenceListFlight",
"Flight": [
{
"@type": "FlightDetail",
"distance": 2483,
"duration": "PT5H9M",
"carrier": "AS",
"number": "981",
"operatingCarrierName": "ALASKA AS HAWAIIAN AIRLINES",
"equipment": "321",
"id": "f1s1",
"Departure": {
"@type": "DepartureDetail",
"location": "OGG",
"date": "2026-10-10",
"time": "12:20:00"
},
"Arrival": {
"@type": "ArrivalDetail",
"terminal": "6",
"location": "LAX",
"date": "2026-10-10",
"time": "20:29:00"
},
"AvailabilitySourceCode": "P"
},
...
{
"@type": "FlightDetail",
"distance": 2483,
"duration": "PT5H20M",
"carrier": "DL",
"number": "463",
"equipment": "76W",
"id": "f1s4",
"Departure": {
"@type": "DepartureDetail",
"location": "OGG",
"date": "2026-10-10",
"time": "13:10:00"
},
"Arrival": {
"@type": "ArrivalDetail",
"terminal": "3",
"location": "LAX",
"date": "2026-10-10",
"time": "21:30:00"
},
"AvailabilitySourceCode": "Q"
},
...
{
"@type": "FlightDetail",
"distance": 2553,
"duration": "PT5H26M",
"carrier": "AS",
"number": "878",
"operatingCarrierName": "ALASKA AS HAWAIIAN AIRLINES",
"equipment": "321",
"id": "f2s2",
"Departure": {
"@type": "DepartureDetail",
"terminal": "1",
"location": "HNL",
"date": "2026-10-10",
"time": "10:51:00"
},
"Arrival": {
"@type": "ArrivalDetail",
"terminal": "6",
"location": "LAX",
"date": "2026-10-10",
"time": "19:17:00"
},
"AvailabilitySourceCode": "P"
},
{
"@type": "FlightDetail",
"distance": 85,
"duration": "PT54M",
"carrier": "9X",
"number": "521",
"equipment": "CNC",
"id": "f2s3",
"Departure": {
"@type": "DepartureDetail",
"location": "JHM",
"date": "2026-10-10",
"time": "07:10:00"
},
"Arrival": {
"@type": "ArrivalDetail",
"terminal": "3",
"location": "HNL",
"date": "2026-10-10",
"time": "08:04:00"
},
"AvailabilitySourceCode": "A"
},
{
"@type": "FlightDetail",
"distance": 2553,
"duration": "PT5H39M",
"carrier": "AA",
"number": "162",
"equipment": "32Q",
"id": "f2s4",
"Departure": {
"@type": "DepartureDetail",
"terminal": "2",
"location": "HNL",
"date": "2026-10-10",
"time": "14:06:00"
},
"Arrival": {
"@type": "ArrivalDetail",
"location": "LAX",
"date": "2026-10-10",
"time": "22:45:00"
},
"AvailabilitySourceCode": "S"
},
{
"@type": "FlightDetail",
"distance": 85,
"duration": "PT54M",
"carrier": "9X",
"number": "521",
"equipment": "CNC",
"id": "f2s5",
"Departure": {
"@type": "DepartureDetail",
"location": "JHM",
"date": "2026-10-10",
"time": "07:10:00"
},
"Arrival": {
"@type": "ArrivalDetail",
"terminal": "3",
"location": "HNL",
"date": "2026-10-10",
"time": "08:04:00"
},
"AvailabilitySourceCode": "C"
},
...
]
},
{
"@type": "ReferenceListProduct",
...
},
{
"@type": "ReferenceListTermsAndConditions",
"TermsAndConditions": [
...
},
{
"@type": "ReferenceListBrand",
"Brand": [
{
"@type": "Brand",
"name": "SAVER",
"tier": 1,
"id": "f1b0",
"Identifier": {
"value": "2151972"
}
},
{
"@type": "Brand",
"name": "DELTA MAIN BASIC",
"tier": 1,
"id": "f1b1",
"Identifier": {
"value": "2096034"
}
},
{
"@type": "Brand",
"name": "FRUGAL",
"tier": 1,
"id": "f2b0",
"Identifier": {
"value": "918343"
}
},
{
"@type": "Brand",
"name": "MAIN CABIN",
"tier": 2,
"id": "f2b1",
"Identifier": {
"value": "2139068"
}
},
{
"@type": "Brand",
"name": "MAIN",
"tier": 2,
"id": "f2b2",
"Identifier": {
"value": "2151971"
}
}
]
}
]
}
}