Flight Fare Calendar API

Guidance and examples for accessing the Flight Fare Calendar API

The Flight Fare Calendar API will return the lowest fares for multiple days so that those fares can be easily be displayed as a booking widget calendar.

Endpoint

Method	Endpoint
GET	https://apim.expedia.com/flights/farecalendar

Required Headers

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

Optional Headers

Accept-Encoding:	gzip more info on gzip

Example of Fare Calendar Request

Fare Calendar Request - One Way

Request

https://apim.expedia.com/flights/farecalendar?segment1.origin=LAS&segment1.destination=SEA&departureDate=2021-05-17

Response

{
	"Offers": [{
			"DepartureDate": "2021-05-18",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "128.39",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-21",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "202.19",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-23",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "137.19",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-24",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "123.41",
					"Currency": "USD"
				}
			}
		}
	],
	"TransactionId": "0f2bc850-62bd-11ea-9e71-0aae9a66c99a"
}

Fare Calendar Request - Roundtrip

Request - Outbound

https://apim.expedia.com/flights/farecalendar?segment1.origin=LAS&segment1.destination=SEA&segment2.origin=SEA&segment2.destination=LAS&departureDate=2021-05-17&trip=outbound

Request - Inbound

https://apim.expedia.com/flights/farecalendar?segment1.origin=LAS&segment1.destination=SEA&segment2.origin=SEA&segment2.destination=LAS&departureDate=2021-05-17&trip=inbound

Response

{
	"Offers": [{
			"DepartureDate": "2021-05-24",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "128.39",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-25",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "202.19",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-26",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "137.19",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDateTime": "2021-05-27",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "123.41",
					"Currency": "USD"
				}
			}
		}
	],
	"TransactionId": "0f2bc850-62bd-11ea-9e71-0aae9a66c99a"
}

Fare Calendar Request - with Segment Details

Request

https://apim.expedia.com/flights/farecalendar?segment1.origin=LAS&segment1.destination=SEA&segment2.origin=SEA&segment2.destination=LAS&departureDate=2021-05-17&trip=inbound&includeSegmentDetails=true

Response

{
	"Offers": [{
			"DepartureDate": "2021-05-24",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "128.39",
					"Currency": "USD"
				}
			},
			"Segments": [{
					"Legs": [{
						"DepartureAirport": {
							"Code": "LAS"
						},
						"ArrivalAirport": {
							"Code": "SEA"
						},
						"DepartureDateTime": "2021-05-24",
						"ArrivalDateTime": "2021-05-24",
						"FlightNumber": "1185",
						"MarketingAirlineCode": "UA",
						"OperatingCarrierCode": "UA",
						"CabinClass": "ECONOMY"
					}]
				},
				{
					"Legs": [{
						"DepartureAirport": {
							"Code": "SEA"
						},
						"ArrivalAirport": {
							"Code": "LAS"
						},
						"DepartureDateTime": "2021-06-08",
						"ArrivalDateTime": "2021-06-08",
						"FlightNumber": "1135",
						"MarketingAirlineCode": "UA",
						"OperatingCarrierCode": "UA",
						"CabinClass": "ECONOMY"
					}]
				}
			]
		},
		{
			"DepartureDate": "2021-05-25",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "202.19",
					"Currency": "USD"
				}
			},
			"Segments": [{
					"Legs": [{
							"DepartureAirport": {
								"Code": "LAS"
							},
							"ArrivalAirport": {
								"Code": "LAX"
							},
							"DepartureDateTime": "2021-05-25",
							"ArrivalDateTime": "2021-05-25",
							"FlightNumber": "505",
							"MarketingAirlineCode": "UA",
							"OperatingCarrierCode": "UA",
							"CabinClass": "ECONOMY"
						},
						{
							"DepartureAirport": {
								"Code": "LAX"
							},
							"ArrivalAirport": {
								"Code": "SEA"
							},
							"DepartureDateTime": "2021-05-25",
							"ArrivalDateTime": "2021-05-25",
							"FlightNumber": "351",
							"MarketingAirlineCode": "UA",
							"OperatingCarrierCode": "UA",
							"CabinClass": "ECONOMY"
						}
					]
				},
				{
					"Legs": [{
							"DepartureAirport": {
								"Code": "SEA"
							},
							"ArrivalAirport": {
								"Code": "LAX"
							},
							"DepartureDateTime": "2021-06-09",
							"ArrivalDateTime": "2021-06-09",
							"FlightNumber": "605",
							"MarketingAirlineCode": "UA",
							"OperatingCarrierCode": "UA",
							"CabinClass": "ECONOMY"
						},
						{
							"DepartureAirport": {
								"Code": "LAX"
							},
							"ArrivalAirport": {
								"Code": "LAS"
							},
							"DepartureDateTime": "2021-06-09",
							"ArrivalDateTime": "2021-06-09",
							"FlightNumber": "451",
							"MarketingAirlineCode": "UA",
							"OperatingCarrierCode": "UA",
							"CabinClass": "ECONOMY"
						}
					]
				}
			]
		},
		{
			"DepartureDate": "2021-05-26",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "137.19",
					"Currency": "USD"
				}
			},
			"Segments": [{
					"Legs": [{
						"DepartureAirport": {
							"Code": "LAS"
						},
						"ArrivalAirport": {
							"Code": "SEA"
						},
						"DepartureDateTime": "2021-05-26",
						"ArrivalDateTime": "2021-05-26",
						"FlightNumber": "142",
						"MarketingAirlineCode": "AS",
						"OperatingCarrierCode": "AS",
						"CabinClass": "ECONOMY"
					}]
				},
				{
					"Legs": [{
						"DepartureAirport": {
							"Code": "SEA"
						},
						"ArrivalAirport": {
							"Code": "LAS"
						},
						"DepartureDateTime": "2021-06-09",
						"ArrivalDateTime": "2021-06-09",
						"FlightNumber": "142",
						"MarketingAirlineCode": "AS",
						"OperatingCarrierCode": "AS",
						"CabinClass": "ECONOMY"
					}]
				}
			]
		}
	],
	"TransactionId": "0f2bc850-62bd-11ea-9e71-0aae9a66c99a"
}

Error Codes

Common Error Codes

HTTP Status Code	Error Code	Error Response	Cause
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	There is a server-side issue that has resulted in a failure.
409	FLIGHT_NOT_AVAILABLE	Requested flight is not available.	The request flight is not longer available

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.