Developer Hub for XAP

Flight Retrieve Booking API

Guidance and examples for accessing the Flight Retrieve Booking API

The Flight Retrieve Booking API allows you to retrieve the details of an Expedia booking (whether booking was done via Booking API or on an Expedia website)

Endpoint

MethodEndpointPrerequisites
GEThttps://apim.expedia.com/flights/bookings/[tripNumber]An active TripNumber from the Flight Booking API.

Required Headers

Key:Expedia API key
Authorization:Expedia API Authorization String
User-Id:username@domain.com

The email address associated with the booking and to which the Booking Confirmation Email will be sent.

Accept:application/vnd.exp-flight.v3+json
Partner-Transaction-Id:Partner TransactionID String

Next Steps

  • Navigate to Expedia website or call customer service to change or cancel.
  • View air fare rules via ApiFareRules website deeplink.

Example of Retrieve Booking Request

Request URL

https://apim.expedia.com/flights/bookings/71260319707

Example Flight Retrieve Booking Response

{
    "Title": "My Flight Booking",
    "TransactionId": "80c845a0-b401-4c85-b4a5-f7287a1836f4",
    "ItineraryNumber": 7160749401,
    "BookingDateTime": "2021-07-14T09:00:19-07:00",
    "TripStartTime": "2021-07-11T13:20:00-08:00",
    "TripEndTime": "2021-07-13T21:29:00-08:00",
    "SplitTicket": false,
    "Status": "BOOKED",
    "LastUpdateDateTime": "2021-07-14T10:00:19+00:00",
    "PartnerAgentId": "123456",
    "AirlineConfirmations": [
        {
            "MarketingAirlineCode": "UA",
            "ConfirmationNumber": "HVVNJ9"
        },
        {
            "MarketingAirlineCode": "UA",
            "ConfirmationNumber": "LE15N1"
        }
    ],
    "PartnerConfirmationNumber": "hello123",
    "GDSLocators": [
        "WUPGWC"
    ],
    "Travelers": [
        {
            "Name": {
                "FirstName": "John",
                "MiddleName": "Edward",
                "LastName": "Doe"
            },
            "Gender": "Male",
            "DateOfBirth": "1978-10-23",
            "PassengerType": "ADULT",
            "TsaNumber": "100000001",
            "RedressNumber": "1234567",
            "Tickets": [
                {
                    "MarketingAirlineCode": "UA",
                    "ConfirmationNumber": "HVVNJ9",
                    "TicketNumber": "0277365112380",
                    "TicketingDateTime": "2021-05-12T02:03:00+00:00",
                    "Coupons": [
                        {
                            "Status": "Open",
                            "FlightNumber": "2530"
                        }
                    ],
                    "Price": {
                        "BasePrice": {
                            "Value": "223.00",
                            "Currency": "USD"
                        },
                        "TotalTaxes": {
                            "Value": "10.10",
                            "Currency": "USD"
                        }
                    },
                    "RefundPenalty": {
                        "PreTripChange": {
                            "Allow": "YES",
                            "Penalty": {
                                "Value": "300.00",
                                "Currency": "USD"
                            }
                        },
                        "PreTripCancel": {
                            "Allow": "NO"
                        },
                        "EnrouteChange": {
                            "Allow": "YES",
                            "Penalty": {
                                "Value": "300.00",
                                "Currency": "USD"
                            }
                        },
                        "EnrouteCancel": {
                            "Allow": "NO",
                            "Transferable": "NO",
                            "NameChangeAllowed": "NO"
                        }
                    }
                }
            ]
        },
        {
            "Name": {
                "FirstName": "Mary",
                "MiddleName": "Edward",
                "LastName": "Ann"
            },
            "Gender": "Female",
            "DateOfBirth": "1982-10-11",
            "PassengerType": "ADULT",
            "Tickets": [
                {
                    "MarketingAirlineCode": "UA",
                    "ConfirmationNumber": "HVVNJ9",
                    "TicketNumber": "0277365158980",
                    "TicketingDateTime": "2021-05-12T02:03:00+00:00",
                    "Coupons": [
                        {
                            "Status": "Open",
                            "FlightNumber": "2530"
                        }
                    ],
                    "Price": {
                        "BasePrice": {
                            "Value": "223.00",
                            "Currency": "USD"
                        },
                        "TotalTaxes": {
                            "Value": "10.10",
                            "Currency": "USD"
                        }
                    },
                    "Refundable": false,
                    "RefundPenalty": {
                        "PreTripChange": {
                            "Allow": "YES",
                            "Penalty": {
                                "Value": "300.00",
                                "Currency": "USD"
                            }
                        },
                        "PreTripCancel": {
                            "Allow": "NO"
                        },
                        "EnrouteChange": {
                            "Allow": "YES",
                            "Penalty": {
                                "Value": "300.00",
                                "Currency": "USD"
                            }
                        },
                        "EnrouteCancel": {
                            "Allow": "NO",
                            "Transferable": "NO",
                            "NameChangeAllowed": "NO"
                        }
                    }
                }
            ]
        }
    ],
    "SeatConfirmations": [
        {
            "FlightNumber": "816",
            "DepartureAirportCode": "SEA",
            "ArrivalAirportCode": "SFO",
            "DepartureDate": "2021-07-11",
            "TravelerSeats": [
                {
                    "Name": {
                        "FirstName": "John",
                        "MiddleName": "Edward",
                        "LastName": "Doe"
                    },
                    "SeatNumber": "19C",
                    "CabinClass": "Coach"
                },
                {
                    "Name": {
                        "FirstName": "Mary",
                        "MiddleName": "Edward",
                        "LastName": "Ann"
                    },
                    "SeatNumber": "19B",
                    "CabinClass": "Coach"
                }
            ]
        },
        {
            "FlightNumber": "733",
            "DepartureAirportCode": "SFO",
            "ArrivalAirportCode": "SEA",
            "DepartureDate": "2021-07-13",
            "TravelerSeats": [
                {
                    "Name": {
                        "FirstName": "John",
                        "MiddleName": "Edward",
                        "LastName": "Doe"
                    },
                    "SeatNumber": "17A",
                    "CabinClass": "Coach"
                },
                {
                    "Name": {
                        "FirstName": "Mary",
                        "MiddleName": "Edward",
                        "LastName": "Ann"
                    },
                    "SeatNumber": "17C",
                    "CabinClass": "Coach"
                }
            ]
        }
    ],
    "Segments": [
        {
            "SegmentId": "MTAyMTM0NjQzMTE=",
            "BasicEconomy": false,
            "Links": {
                "ApiBaggageFees": {
                    "Accept": "application/vnd.exp-flight.v1+json",
                    "Method": "GET",
                    "Href": "https://apim.expedia.com/flights/baggagefees/CkYKAkFBEgJBQRoKMjAxOS0wMy0wNyIDTEFYKgoyMDE5LTAzLTA3MgNPUkQ6AUJCCFMzQUtaTkIySgdFQ09OT01ZUgQxMDI5EgNVU0QaAmtn"
                }
            },
            "AirportChange": false,
            "Legs": [
                {
                    "DepartureAirport": {
                        "Code": "SEA",
                        "Latitude": "33.94415",
                        "Longitude": "-118.4032"
                    },
                    "ArrivalAirport": {
                        "Code": "SFO",
                        "Latitude": "33.94415",
                        "Longitude": "-118.4032"
                    },
                    "DepartureDateTime": "2021-07-11T13:20:00-08:00",
                    "ArrivalDateTime": "2021-07-11T15:21:00-08:00",
                    "FlightNumber": "816",
                    "MarketingAirlineCode": "UA",
                    "FlightDuration": "PT2H1M",
                    "EquipmentChange": false,
                    "GDSLocator": "WUPGWC",
                    "BookingCode": "N",
                    "AirlineConfirmation": {
                        "MarketingAirlineCode": "UA",
                        "ConfirmationNumber": "LE15N1"
                    },
                    "Amenities": {
                        "Entertainment": {
                            "Available": "YES",
                            "Types": [
                                "ON_DEMAND",
                                "STREAMING"
                            ]
                        },
                        "Wifi": {
                            "Available": "YES"
                        },
                        "Power": {
                            "Available": "YES"
                        }
                    }
                }
            ]
        },
        {
            "Links": {
                "ApiBaggageFees": {
                    "Accept": "application/vnd.exp-flight.v1+json",
                    "Method": "GET",
                    "Href": "https://apim.expedia.com/flights/baggagefees/CkYKAkRMEgJETBoKMjAxOS0wMy0wMSIDT1JEKgoyMDE5LTAzLTAxMgNNU1A6AUVCCFZBM05BMEJBSgdFQ09OT01ZUgQyNTI3CjwKAkRMEgJETBoKMjAxOS0wMy0wMSIDTVNQKgoyMDE5LTAzLTAyMgNMQVg6AUVKB0VDT05PTVlSBDE0MDQSA1VTRBoCa2c"
                }
            },
            "AirportChange": false,
            "Legs": [
                {
                    "DepartureAirport": {
                        "Code": "SFO"
                    },
                    "ArrivalAirport": {
                        "Code": "SEA"
                    },
                    "DepartureDateTime": "2021-07-13T19:30:00-08:00",
                    "ArrivalDateTime": "2021-07-13T21:29:00-08:00",
                    "FlightNumber": "733",
                    "MarketingAirlineCode": "UA",
                    "FlightDuration": "PT1H59M",
                    "EquipmentChange": false,
                    "GDSLocator": "WUPGWC",
                    "BookingCode": "N",
                    "AirlineConfirmation": {
                        "MarketingAirlineCode": "UA",
                        "ConfirmationNumber": "LE15N1"
                    },
                    "Amenities": {
                        "Entertainment": {
                            "Available": "YES",
                            "Types": [
                                "ON_DEMAND",
                                "STREAMING"
                            ]
                        },
                        "Wifi": {
                            "Available": "YES"
                        },
                        "Power": {
                            "Available": "YES"
                        }
                    }
                }
            ]
        }
    ],
    "Price": {
        "TotalPrice": {
            "Value": "272.40",
            "Currency": "USD"
        },
        "BasePrice": {
            "Value": "226.05",
            "Currency": "USD"
        },
        "TotalTaxes": {
            "Value": "45.35",
            "Currency": "USD"
        },
        "Fees": [
            {
                "Value": "1.00",
                "Currency": "USD",
                "Name": "AirServiceFee"
            }
        ],
        "TotalTaxesAndFees": {
            "Value": "10.10",
            "Currency": "USD"
        },
        "PricePerPassengerCategory": [
            {
                "Category": "ADULT",
                "Count": 1,
                "BasePrice": {
                    "Value": "226.05",
                    "Currency": "USD"
                },
                "TotalTaxes": {
                    "Value": "45.35",
                    "Currency": "USD"
                }
            }
        ]
    },
    "Links": {
        "ApiFareRules": {
            "Accept": "application/vnd.exp-flight.v1+json",
            "Method": "GET",
            "Href": "https://apim.expedia.com/flights/farerules/CgVjb2FjaBoJUHVibGlzaGVkIgd1bmtub3duKgl1bml2ZXJzYWwyAkRMQksIARIZMjAxOS0wMy0wMVQxOTo1NDowMC0wNjowMBoDTVNQIgNPUkQqAkRMMghWQTNOQTBCQUIGQ0hJTEFYSgVTYWJyZWoFQURVTFRCSwgCEhkyMDE5LTAzLTAxVDIyOjMwOjAwLTA2OjAwGgNMQVgiA01TUCoCREwyCFZBM05BMEJBQgZDSElMQVhKBVNhYnJlagVBRFVMVA+CgVjb2FjaBoJUHVibGlzaGVkIgd1bmtub3duKgl1bml2ZXJzYWwyAkFBQksIARIZMjAxOS0wMy0wN1QxNToyMDowMC0wODowMBoDT1JEIgNMQVgqAkFBMghTM0FLWk5CMkIGTEFYQ0hJSgVTYWJyZWoFQURVTFQ"
        }
    },
    "FareOptions": [
        {
            "SegmentIds": [
                "MTAyMTM0NjQzMTE="
            ],
            "Amenities": {
                "SeatChoice": {
                    "Availability": "INCLUDED"
                },
                "CarryOnBag": {
                    "BagNumber": 1,
                    "Availability": "INCLUDED"
                },
                "CheckedBag": [
                    {
                        "BagNumber": 1,
                        "Availability": "AVAILABLE_FOR_FEE"
                    }
                ],
                "Change": {
                    "Availability": "AVAILABLE_FOR_FEE"
                },
                "Refund": {
                    "Availability": "NOT_AVAILABLE"
                },
                "PersonalItem": {
                    "Availability": "INCLUDED"
                },
                "Upgrade": {
                    "Availability": "NOT_AVAILABLE"
                },
                "BoardingGroup": [
                    "BASED_ON_SEAT_LOCATION"
                ]
            }
        }
    ],
    "PartnerMetaData": {
        "SampleKey": "SampleValue",
        "SampleKey2": "SampleValue2"
    }
}

Example Flight Retrieve Booking Response with Changes to Itinerary

{
    "Title": "My Flight Booking",
    "TransactionId": "1889f2ad-ee4b-4892-ba29-eafa527c240e",
    "ItineraryNumber": 71292254084,
    "Status": "Booked",
    "AirlineConfirmations": [
        {
            "MarketingAirlineCode": "AS",
            "ConfirmationNumber": "JJRYSL"
        },
        {
            "MarketingAirlineCode": "AS",
            "ConfirmationNumber": "RYSLLK"
        }
    ],
    "BookingDateTime": "2021-07-14T13:27:25-0700",
    "LastUpdateDateTime": "2021-07-14T16:00:19+00:00",
    "TripStartTime": "2021-07-23T21:50:00-0700",
    "TripEndTime": "2021-07-30T14:50:00-0400",
    "PartnerAgentId": "123456",
    "PartnerConfirmationNumber": "hello123",
    "GDSLocators": [
        "XESQIR",
        "QHXZHV"
    ],
    "Travelers": [
        {
            "Name": {
                "FirstName": "John",
                "MiddleName": "Edward",
                "LastName": "Doe"
            },
            "Gender": "Male",
            "PassengerType": "ADULT",
            "DateOfBirth": "1978-10-23",
            "Tickets": [
                {
                    "MarketingAirlineCode": "AS",
                    "TicketNumber": "0277959151089",
                    "ConfirmationNumber": "JJRYSL",
                    "TicketingDateTime": "2021-05-12T02:03:00+00:00",
                    "Coupons": [
                        {
                            "Status": "Open",
                            "FlightNumber": "2530"
                        }
                    ],
                    "Price": {
                        "BasePrice": {
                            "Value": "223.00",
                            "Currency": "USD"
                        },
                        "TotalTaxes": {
                            "Value": "10.10",
                            "Currency": "USD"
                        }
                    }
                }
            ]
        },
        {
            "Name": {
                "FirstName": "Mary",
                "MiddleName": "Edward",
                "LastName": "Ann"
            },
            "Gender": "Female",
            "PassengerType": "ADULT",
            "DateOfBirth": "1980-09-30",
            "Tickets": [
                {
                    "MarketingAirlineCode": "AS",
                    "TicketNumber": "8384940208413",
                    "ConfirmationNumber": "RYSLLK",
                    "TicketingDateTime": "2021-05-12T02:03:00+00:00",
                    "Coupons": [
                        {
                            "Status": "Open",
                            "FlightNumber": "2530"
                        }
                    ],
                    "Price": {
                        "BasePrice": {
                            "Value": "223.00",
                            "Currency": "USD"
                        },
                        "TotalTaxes": {
                            "Value": "10.10",
                            "Currency": "USD"
                        }
                    }
                }
            ]
        }
    ],
    "Segments": [
        {
            "Links": {
                "ApiBaggageFees":{
                    "Accept":"application/vnd.exp-flight.v1+json",
                    "Method":"GET",
                    "Href":"https://apim.expedia.com/flights/baggagefees/CkAKAkFTGgoyMDE3LTEwLTAxIgNTRUEqCjIwMTctMTAtMDEyA0xBUzoBUkIHUjIxQ1ZONUoHRUNPTk9NWVIDNjE2EgNVU0QaAmtn"
                }
            },
            "AirportChange":false,
            "Legs": [
                {
                    "DepartureAirport": {
                        "Code": "SEA"
                    },
                    "ArrivalAirport": {
                        "Code": "LAS"
                    },
                    "DepartureDateTime": "2021-07-23T21:50:00-07:00",
                    "ArrivalDateTime": "2021-07-24T00:14:00-07:00",
                    "FlightNumber": "608",
                    "MarketingAirlineCode": "AS",
                    "FlightDuration": "PT2H24M",
                    "EquipmentChange":false,
                    "GDSLocators": "XESQIR",
                    "AirlineConfirmation": {
                        "MarketingAirlineCode": "AS",
                        "ConfirmationNumber": "JJRYSL"
                    }
                }
            ]
        },
        {
            "Links": {
                "ApiBaggageFees":{
                    "Accept":"application/vnd.exp-flight.v1+json",
                    "Method":"GET",
                    "Href":"https://apim.expedia.com/flights/baggagefees/CkAKAkFTGgoyMDE3LTEwLTAxIgNTRUEqCjIwMTctMTAtMDEyA0xBUzoBUkIHUjIxQ1ZONUoHRUNPTk9NWVIDNjE2EgNVU0QaAmtn"
                }
            },
            "AirportChange":false,
            "Legs": [
                {
                    "DepartureAirport": {
                        "Code": "SEA"
                    },
                    "ArrivalAirport": {
                        "Code": "SFO"
                    },
                    "DepartureDateTime": "2021-07-30T12:30:00-05:00",
                    "ArrivalDateTime": "2021-07-30T14:50:00-05:00",
                    "MarketingAirlineCode": "AS",
                    "FlightDuration": "PT2H20M",
                    "EquipmentChange":false,
                    "GDSLocators": "QHXZHV",
                    "AirlineConfirmation": {
                        "MarketingAirlineCode": "AS",
                        "ConfirmationNumber": "RYSLLK"
                    }
                }
            ]
        }
    ],
    "Price": {
        "BasePrice": {
            "Value": "128.38",
            "Currency": "USD"
        },
        "TotalPrice": {
            "Value": "145.60",
            "Currency": "USD"
        },
        "Discount": {
            "Value": "20.80",
            "Currency": "USD"
        },
        "TotalTaxes": {
            "Value": "38.02",
            "Currency": "USD"
        },
        "PricePerPassengerCategory": [
            {
                "Category": "Adult",
                "BasePrice": {
                    "Value": "64.19",
                    "Currency": "USD"
                },
                "TotalTaxes": {
                    "Value": "19.01",
                    "Currency": "USD"
                },
                "Count": 2
            }
        ]
    },
    "Links": {
        "ApiFareRules":{
            "Accept":"application/vnd.exp-flight.v1+json",
            "Method":"GET",
            "Href":"https://apim.expedia.com/flights/farerules/GglQdWJsaXNoZWQiB3Vua25vd24qCXVuaXZlcnNhbDICQVNCUggBEhMyMDE3LTEwLTAxVDAwOjAwOjAwGgNMQVMiA1NFQSoCQVMyB1IyMUNWTjVCBlNFQUxBU0oFU2FicmViEzIwMTctMDYtMjRUMDA6MDA6MDBCUQgCEhMyMDE3LTEwLTAxVDAwOjAwOjAwGgNTRUEiA0xBUyoCQVMyBlIyMVZONUIGTEFTU0VBSgVTYWJyZWITMjAxNy0wNi0yNFQwMDowMDowMA"
        }
    }
}

Example Flight Retrieve Booking Error Response

{
    "Errors": [{
        "Code": "GUEST_LOGIN_NOT_FOUND",
        "Description": "Itineraries were not found. Please provide valid email and trip numbers."
    }],
    "TransactionId": "fbf4d489-efe6-4226-94c1-8d9f239e21b1"
}


Error Codes

Common Error Codes

HTTP Status CodeError CodeError Message
400INVALID_CLIENT_KEYInvalid client key: xxx
400INVALID_RETRIEVE_REQUESTRetrieve Failed. Invalid request body supplied.
400

500		RETRIEVE_APPLICATION_ERRORApplication Error.
400ITINERARY_NOT_FOUNDThe itinerary was not found. Please provide valid user-id and itinerary number.
500 RETRIEVE_ITINERARY_ERROR Retrieve Failed. Unable to retrieve data for Trip Numbers %s. Please try again.
Error occurred while retrieving data for trip number: %s.
Invalid Input. Unable to retrieve data for Trip Number : %s.
400 INVALID_ITINERARY_NUMBER Invalid Input. Please provide the valid trip number.
Invalid Input. Unable to retrieve data for Trip Number : %s.
400UNKNOWN_PATHUnknown request path
400INVALID_API_VERSIONAPI version is either missing or invalid.
Please provide a correct API version in the Accept header as following:
Accept:application/ vnd.exp-<product>.<version>+json (product={flight,hotel}, version={v1,v2,v3})
400INVALID_USER_IDUser-Id in http headers is missing or invalid.
400PARTNER_TRANSACTION_ID_MISSINGPartner transaction Id in http headers is missing.
400ITINERARY_NOT_FOUND_FOR_PARTNERItinerary was not found for client key.
400ITIN_NOT_ASSOCIATED_WITH_CLIENT_KEYThe itinerary is not associated with client key.
400UNSUPPORTED_PACKAGE_TYPERequested Product/Products are not supported for %s trip.

API details

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.


Did you find this page helpful?
How can we improve this content?
Thank you for helping us improve!

Privacy Statement Cookie Statement Terms of Use

Expedia, Inc. is not responsible for content on external Web sites.
© 2023 Expedia, Inc., an Expedia Group company. All rights reserved. Expedia and the Airplane Logo are trademarks or registered trademarks of Expedia, Inc. CST# 2029030-50.