Flight Baggage Fee API

Guidance and examples for accessing the Flight Baggage Fee API

The Flight Baggage Fee API allows you to search a complete listing of all fees associated with baggage on a selected flight.

Endpoint

Method	Endpoint	Prerequisites
GET	https://apim.expedia.com/flights/baggagefees/[offerToken]	To complete a Details API call you must have an offerToken from the Listing API

Required Headers

Key:	Expedia API key
Authorization:	Expedia API Authorization String
Accept:	application/vnd.exp-flight.v1+json
Partner-Transaction-Id:	Partner TransactionID String

Optional Headers

Accept-Encoding:	gzip

Example Baggage Fee Request

Request

https://apim.expedia.com/flights/baggagefees/CjMKAkRMGgoyMDE3LTA2LTIwIgNMQVMyA0xBWDoBQUIIVUFBMEFXRk5KBWZpcnN0UgM1ODQSA1VTRA

Successful Response

Response

{
  "FlightBaggageFees": [
    {
      "FlightSegment": {
        "AirlineCode": "UA",
        "AirlineName": "United Airlines",
        "DepartureAirport": {
          "Code": "SFO"
        },
        "ArrivalAirport": {
          "Code": "IAD"
        },
        "CabinClass": "COACH",
        "Links": {
          "WebBaggageFees": {
            "Method": "GET",
            "Href": "https://www.united.com/web/en-US/content/travel/baggage/default.aspx"
          }
        }
      },
      "BaggageFees": [
        {
          "BagType": "FIRST_BAG",
          "FixedCharge": {
            "Value": "10.50",
            "Currency": "USD"
          },
          "WeightUnit": "kg",
          "Weight": "21.6",
          "Application": "per"
        },
        {
          "BagType": "PREPAID_CARRY_ON",
          "MaxCharge": {
            "Value": "10.25",
            "Currency": "USD"
          },
          "MinCharge": {
            "Value": "5.75",
            "Currency": "USD"
          },
          "WeightUnit": "kg",
          "Weight": "21.6",
          "Application": "per"
        }
      ]
    }
  ],
  "TransactionId": "a9e371c4-89d9-4f9c-8df7-df105830e7fe"
}

Baggage Fee for Both Range and Fixed Amount

Baggage Fee Response

{
  "FlightBaggageFees": [
    {
      "FlightSegment": {
        "AirlineCode": "UA",
        "AirlineName": "United Airlines",
        "DepartureAirport": {
          "Code": "SFO"
        },
        "ArrivalAirport": {
          "Code": "IAD"
        },
        "CabinClass": "COACH",
        "Links": {
          "WebBaggageFees": {
            "Method": "GET",
            "Href": "https://www.united.com/web/en-US/content/travel/baggage/default.aspx"
          }
        }
      },
      "BaggageFees": [
        {
          "BagType": "CARRY_ON",
          "FixedCharge": {
            "Value": "0.0",
            "Currency": "USD"
          },
          "WeightUnit": "kg",
          "Weight": "21.6",
          "Application": "per"
        },
        {
          "BagType": "FIRST_BAG",
          "FixedCharge": {
            "Value": "10.50",
            "Currency": "USD"
          },
          "WeightUnit": "kg",
          "Weight": "21.6",
          "Application": "per"
        },
        {
          "BagType": "SECOND_BAG",
          "FixedCharge": {
            "Value": "10.50",
            "Currency": "USD"
          },
          "WeightUnit": "kg",
          "Weight": "21.6",
          "Application": "per"
        },
        {
          "BagType": "PREPAID_CARRY_ON",
          "MaxCharge": {
            "Value": "10.25",
            "Currency": "USD"
          },
          "MinCharge": {
            "Value": "5.75",
            "Currency": "USD"
          },
          "WeightUnit": "kg",
          "Weight": "21.6",
          "Application": "per"
        }
      ]
    }
  ],
  "TransactionId": "a9e371c4-89d9-4f9c-8df7-df105830e7fe"
}

Baggage Fee with Carry On Bag Only (all others unknown)

Baggage Fee Response

{
  "FlightBaggageFees": [
    {
      "FlightSegment": {
        "AirlineCode": "UA",
        "AirlineName": "United Airlines",
        "DepartureAirport": {
          "Code": "SFO"
        },
        "ArrivalAirport": {
          "Code": "IAD"
        },
        "CabinClass": "COACH",
        "Links": {
          "WebBaggageFees": {
            "Method": "GET",
            "Href": "https://www.united.com/web/en-US/content/travel/baggage/default.aspx"
          }
        }
      },
      "BaggageFees": [
        {
          "BagType": "CARRY_ON",
          "FixedCharge": {
            "Value": "0.0",
            "Currency": "USD"
          },
          "WeightUnit": "kg",
          "Weight": "21.6",
          "Application": "per"
        }
      ]
    }
  ],
  "TransactionId": "a9e371c4-89d9-4f9c-8df7-df105830e7fe"
}

Warning - No Baggage Fee Information Available

Baggage Fee Response

{
  "Warnings": [
    {
      "Code": "NO_FEE_INFO",
      "Description": "Fee Information is not available"
    }
  ],
  "FlightBaggageFees": [
    {
      "FlightSegment": {
        "AirlineCode": "UA",
        "AirlineName": "United Airlines",
        "DepartureAirport": {
          "Code": "SFO"
        },
        "ArrivalAirport": {
          "Code": "IAD"
        },
        "CabinClass": "COACH",
        "Links": {
          "WebBaggageFees": {
            "Method": "GET",
            "Href": "https://www.united.com/web/en-US/content/travel/baggage/default.aspx"
          }
        }
      }
    }
  ],
  "TransactionId": "a9e371c4-89d9-4f9c-8df7-df105830e7fe"
}

Error Codes

Common Error Codes

HTTP Status Code	Error Code	Error Response	Cause
400	INVALID_LOCALE	Please provide a valid locale. Please verify the expedia provided valid locales	The locale provided in the request is not supported by API.
400	INVALID_ACCEPT_HEADER	Please provide a valid Accept header	The accept header provided is not as per the documentation
500	SERVER_ERROR	An error has occurred while processing the request	Server side error like backend service has some issues or some issues in EWS Air service

Warning Code

Common Warning Codes

HTTP Status Code	Error Code	Error Response	Cause
200	NO_RESULTS_FOUND	No results found for the request	There are no results available for the request
200	NO_FEE_INFO	Fee Information is not available	Baggage fee related information is not available for the request.

Here, you can explore the endpoint definitions for this API, then go to the API Explorer to try out all the XAP endpoints, download OpenAPI specs, or download our Postman collections. Testing with one or all of these options will give you an understanding of how the examples and schema definitions compare to the actual output.