Skip to main content

Refresh Prices - Fare Attribute Data

info

This feature is only accessible by selected partners on an approval basis. Please do not circulate this externally.

Fare attributes are a set of fields that describe the availability and cost of additional services such as cabin baggage, checked baggage, cancellation policies, or seat reservations for a given pricing option.

Within the Refresh Prices flow, these attributes are exposed in two complementary ways:

  • pricingOptionFare - details the fare attributes available for each individual pricing option (e.g., whether checked baggage is included, what the cancellation policy is).
  • fareAttributeFilters - provides a pre-computed mapping of fare attributes to pricing option IDs, which makes it easy to filter options in the UI (e.g., only show options that include a checked bag).

Skyscanner example​

On the Booking Panel screen, users can see all pricing options for a given itinerary. Fare attribute data powers both the information displayed and the filtering options:

FeatureDescription
Included Attributes (blue highlight)The section in blue shows whether cabin and checked baggage are included in the fare. This is mapped from the pricingOptionFare object for each pricing option, where data is available.
Filter Controls (red highlight)The section in red contains buttons such as Cabin Bag and Checked Bag. These labels represent specific fare attributes. When a user selects one or more attributes, the list of pricing options is filtered to only include those options that match. This filtering is powered by the fareAttributeFilters field.

For example, if the user selects Checked Bag, only the pricing options where a checked bag is included in the fare will remain visible.

Sample request for fare attribute data​

There is no need to add any additional fields to the request. However, for fare attribute data to be available, you must ensure:

  • Additional attributes feature is enabled for you by speaking to your Account Manager.
  • You are using a market where the feature is supported.
  • Please consider we do not have data for all flight supply partners due to limited coverage.

Sample response with fare attribute data​

{
  "content": {
    "results": {
      "itineraries": {
        "itinerary-id": {
          "pricingOptions": [
            {
              "agentIds": ["agent"],
              "price": {
                "amount": "123456",
                "unit": "PRICE_UNIT_MILLI",
                "updateStatus": "PRICE_UPDATE_STATUS_CURRENT"
              },
              "id": "id1",
              "pricingOptionFare": {
                "brandNames": ["ECONOMY_FLEX"],
                "legDetails": {
                  "itinerary-id": {
                    "brandNames": ["BASIC ECONOMY"],
                    "cabinBaggage": {
                      "assessment": "ASSESSMENT_INCLUDED",
                      "pieces": 1,
                      "fee": {
                        "amount": "0",
                        "unit": "PRICE_UNIT_MILLI"
                      },
                      "weight": "50lb"
                    },
                    "checkedBaggage": {
                      "assessment": "ASSESSMENT_FEE",
                      "pieces": 0,
                      "fee": {
                        "amount": "80950000000",
                        "unit": "PRICE_UNIT_MILLI"
                      },
                      "weight": "50lb"
                    },
                    "seatPreReservation": {
                      "assessment": "ASSESSMENT_FEE"
                    },
                    "upgradeEligibility": {
                      "assessment": "ASSESSMENT_UNKNOWN"
                    }
                  }
                },
                "cabinBaggage": {
                  "assessment": "ASSESSMENT_INCLUDED",
                  "pieces": 1,
                  "fee": {
                    "amount": "0",
                    "unit": "PRICE_UNIT_MILLI"
                  },
                  "weight": ""
                },
                "checkedBaggage": {
                  "assessment": "ASSESSMENT_INCLUDED",
                  "pieces": 1,
                  "fee": {
                    "amount": "0",
                    "unit": "PRICE_UNIT_MILLI"
                  },
                  "weight": "23kg"
                },
                "advanceChange": {
                  "assessment": "ASSESSMENT_FEE"
                },
                "cancellation": {
                  "assessment": "ASSESSMENT_FEE"
                },
                "seatPreReservation": {
                  "assessment": "ASSESSMENT_UNKNOWN"
                },
                "upgradeEligibility": {
                  "assessment": "ASSESSMENT_UNKNOWN"
                }
              }
            },
            {
              // ...
            }
          ]
        }
      },
      "fareAttributeFilters": {
        "itinerary-id": {
          "fareAttributeFilters": [
            {
              "fareAttributes": [],
              "pricingOptionIds": ["id1", "id2", "id3", "id4"]
            },
            {
              "fareAttributes": ["FARE_ATTRIBUTE_CABIN_BAGGAGE"],
              "pricingOptionIds": ["id1", "id3"]
            },
            {
              "fareAttributes": ["FARE_ATTRIBUTE_CHECKED_BAGGAGE"],
              "pricingOptionIds": ["id1", "id3", "id4"]
            },
            {
              "fareAttributes": [
                "FARE_ATTRIBUTE_CABIN_BAGGAGE",
                "FARE_ATTRIBUTE_CHECKED_BAGGAGE"
              ],
              "pricingOptionIds": ["id1", "id2"]
            }
          ]
        }
      }
    }
  }
}