Flight Booking API
Guidance and examples for accessing the Flight Booking API
Important: All partners leveraging XAP Booking APIs from any line of business must be aware of the PSD2 and 3DSv2 initiatives that launched in September, 2019. Please read the article on XAP Support of PSD2 and 3DSv2 Bookings for more information.
The Flight Booking API allows you to enable booking of up to 6 passengers on tickets with up to 5 stops.
Endpoint
Method | Endpoint | Prerequisite |
---|---|---|
POST | https://apim.expedia.com/flights/bookings/[offerToken] | The offerToken from the Flight Details 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. |
Content-Type: | application/json |
Accept: | application/vnd.exp-flight.v3+json |
Partner-Transaction-Id: | Partner TransactionID String |
Next Steps
- Follow web retrieve link to Expedia website to get details.
- View air fare rules via ApiFareRules website deeplink.
Example of Flight Booking Request
Request URL
https://apim.expedia.com/flights/bookings/v5-6bbf6b9b2fe248efbdb1fb95db5b2db9-0-0-1~0~AQoCCAESBwjUBBABGAEgASAMIAcgDSgCUga-QwGATAE~AQogCh4IzpYBEgMyOTIYkgEgi5ABKL_6ajDP-2o4VUAAWAEKIQofCM6WARIEMTA2ORiLkAEgkgEo-ZNrMJGVazhVQABYARIKCAEQARgBKgJOSxgBIgQIARABKAQoAygBKAIwAg?price=138.38¤cy=USD
Request Body
{
"Title": "My Flight Booking",
"Travelers": [{
"Primary": true,
"Name": {
"FirstName": "John",
"LastName": "Doe",
"MiddleName": "Edward"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
},
"Email": "john.doe@gmail.com",
"Passport": {
"CountryCode": "US",
"Number": "123GHY",
"ExpirationDate": "2021-06-11"
},
"Gender": "Male",
"DateOfBirth": "1978-10-23",
"FrequentFlyerPrograms": [{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "12345"
},
{
"MarketingCarrierCode": "BA",
"ProgramCarrierCode": "BA",
"Number": "queen1"
}
],
"TsaNumber": "12345678",
"RedressNumber": "1234567",
"SpecialAssistances": [
"BLIND_WITH_SEEING_EYE_DOG",
"WHEELCHAIR_IMMOBILE"
],
"EmergencyContact": {
"Name": {
"FirstName": "Bobby",
"LastName": "James",
"MiddleName": "Jones"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
}
},
"PassengerType": "ADULT",
"MealPreference": "Kosher",
"SeatPreference": "Window",
"Seats": [{
"SeatNumber": "17A",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-06-27"
},
{
"SeatNumber": "20A",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-06-28"
}
]
},
{
"Primary": false,
"Name": {
"FirstName": "Mary",
"LastName": "Ann",
"MiddleName": "Edward"
},
"Gender": "Female",
"DateOfBirth": "1980-09-30",
"FrequentFlyerPrograms": [{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "12345891"
}],
"TsaNumber": "1234567811",
"RedressNumber": "123456711",
"SpecialAssistances": [
"NONE"
],
"PassengerType": "ADULT",
"MealPreference": "Hindu Vegetarian",
"SeatPreference": "Aisle",
"Seats": [{
"SeatNumber": "17B",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-06-27"
},
{
"SeatNumber": "20B",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-06-28"
}
]
},
{
"Primary": false,
"Name": {
"FirstName": "Little",
"LastName": "Doe",
"MiddleName": "Edward"
},
"Gender": "Male",
"DateOfBirth": "2007-12-10",
"FrequentFlyerPrograms": [{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "1234589"
}],
"TsaNumber": "12345678",
"RedressNumber": "1234567",
"SpecialAssistances": [
"NONE"
],
"PassengerType": "CHILD",
"MealPreference": "Sushi",
"SeatPreference": "Window",
"Seats": [{
"SeatNumber": "17C",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-06-27"
},
{
"SeatNumber": "20C",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-06-28"
}
]
}
],
"FraudCheckId": "2CAAADE1R-654F-43B3-B932-EEDF8764CAA1",
"BillingDetails": {
"CreditCard": {
"CardNumber": "4XXXXXXXXXXXXXX8",
"CardType": "Visa",
"CardSecurityCode": "123",
"ExpirationMonth": "12",
"ExpirationYear": "2025"
},
"Name": {
"FirstName": "John",
"MiddleName": "Edward",
"LastName": "Doe"
},
"Address": {
"Address1": "3333 108th Ave",
"Address2": "Expedia HQ",
"Suite": "15N-107",
"City": "Bellevue",
"Province": "WA",
"Country": "USA",
"PostalCode": "98004"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "425",
"Number": "1234567"
}
},
"AdditionalBookingDetails": {
"MarketingCode": "111abc",
"Source": "browser",
"PartnerAgentId": "123456",
"PartnerConfirmationNumber": "hello123",
"PnrRemarks": [".U*TripId-1128-test", ".U*TripId-1128-test", ".U*93-FREEBIRD-ENROLLED", "U7-US", "U9-17976"]
},
"PartnerMetaData": {
"SampleKey1": "SampleValue1",
"SampleKey2": "SampleValue2"
}
}
Request Body of Flight & Paid Seat booking
{
"Title": "My Flight Booking",
"Travelers": [{
"Primary": true,
"Name": {
"FirstName": "John",
"LastName": "Doe",
"MiddleName": "Edward"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
},
"Email": "john.doe@gmail.com",
"Passport": {
"CountryCode": "US",
"Number": "123GHY",
"ExpirationDate": "2021-06-11"
},
"Gender": "Male",
"DateOfBirth": "1978-10-23",
"FrequentFlyerPrograms": [{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "12345"
},
{
"MarketingCarrierCode": "BA",
"ProgramCarrierCode": "BA",
"Number": "queen1"
}
],
"TsaNumber": "12345678",
"RedressNumber": "1234567",
"SpecialAssistances": [
"BLIND_WITH_SEEING_EYE_DOG",
"WHEELCHAIR_IMMOBILE"
],
"EmergencyContact": {
"Name": {
"FirstName": "Bobby",
"LastName": "James",
"MiddleName": "Jones"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
}
},
"PassengerType": "ADULT",
"MealPreference": "Kosher",
"SeatPreference": "Window",
"Seats": [{
"SeatNumber": "17A",
"SeatToken": "AQogCMWWARIDNzg0GMuTASDjDSj35vwCMKrq_AI4UUAAWAESBRoDQURUGgM1MEs",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-06-27"
},
{
"SeatNumber": "20A",
"SeatToken": "BQogCMWWARIDNzg0GMuTASDjDSj35vwCMKrq_AI4UUAAWAESBRoDQURUGgM1MEM",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-06-28"
}
]
},
{
"Primary": false,
"Name": {
"FirstName": "Mary",
"LastName": "Ann",
"MiddleName": "Edward"
},
"Gender": "Female",
"DateOfBirth": "1980-09-30",
"FrequentFlyerPrograms": [{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "12345891"
}],
"TsaNumber": "1234567811",
"RedressNumber": "123456711",
"SpecialAssistances": [
"NONE"
],
"PassengerType": "ADULT",
"MealPreference": "Hindu Vegetarian",
"SeatPreference": "Aisle",
"Seats": [{
"SeatNumber": "17A",
"SeatToken": "AQogCMWWARIDNzg0GMuTASDjDSj35vwCMKrq_AI4UUAAWAESBRoDQURUGgM1MEs",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-06-27"
},
{
"SeatNumber": "20A",
"SeatToken": "BQogCMWWARIDNzg0GMuTASDjDSj35vwCMKrq_AI4UUAAWAESBRoDQURUGgM1MEM",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-06-28"
}
]
},
{
"Primary": false,
"Name": {
"FirstName": "Little",
"LastName": "Doe",
"MiddleName": "Edward"
},
"Gender": "Male",
"DateOfBirth": "2007-12-10",
"FrequentFlyerPrograms": [{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "1234589"
}],
"TsaNumber": "12345678",
"RedressNumber": "1234567",
"SpecialAssistances": [
"NONE"
],
"PassengerType": "CHILD",
"MealPreference": "Sushi",
"SeatPreference": "Window",
"Seats": [{
"SeatNumber": "17A",
"SeatToken": "AQogCMWWARIDNzg0GMuTASDjDSj35vwCMKrq_AI4UUAAWAESBRoDQURUGgM1MEs",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-06-27"
},
{
"SeatNumber": "20A",
"SeatToken": "BQogCMWWARIDNzg0GMuTASDjDSj35vwCMKrq_AI4UUAAWAESBRoDQURUGgM1MEM",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-06-28"
}
]
}
],
"FraudCheckId": "2CAAADE1R-654F-43B3-B932-EEDF8764CAA1",
"BillingDetails": {
"CreditCard": {
"CardNumber": "4XXXXXXXXXXXXXX8",
"CardType": "Visa",
"CardSecurityCode": "123",
"ExpirationMonth": "12",
"ExpirationYear": "2025"
},
"Name": {
"FirstName": "John",
"MiddleName": "Edward",
"LastName": "Doe"
},
"Address": {
"Address1": "3333 108th Ave",
"Address2": "Expedia HQ",
"Suite": "15N-107",
"City": "Bellevue",
"Province": "WA",
"Country": "USA",
"PostalCode": "98004"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "425",
"Number": "1234567"
}
},
"AdditionalBookingDetails": {
"MarketingCode": "111abc",
"Source": "browser",
"PartnerAgentId": "123456",
"PartnerConfirmationNumber": "hello123",
"PnrRemarks": [".U*TripId-1128-test", ".U*TripId-1128-test", ".U*93-FREEBIRD-ENROLLED", "U7-US", "U9-17976"]
},
"PartnerMetaData": {
"SampleKey1": "SampleValue1",
"SampleKey2": "SampleValue2"
}
}
3DS Book Request
EWS supports 2 ways for 3ds:
- External authentication and EG authorization. in this way, partner use their own service provider to authenticate payment with bank and pass authentication data to EWS for authorization. If partner uses External authentication, MpiData is required.
- EG authentication and EG authorization. in this way, partner integrate EG JS lib to authenticate and authorize payment. If partner uses EG authentication, BrowserData is required.
3DS Book Request - With External authentication
{
"Title": "My Flight Booking",
"Travelers": [
{
"Primary": true,
"Name": {
"FirstName": "San",
"LastName": "Zhang",
"MiddleName": "Edward"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
},
"Email": "ewsbooking@gmail.com",
"Passport": {
"CountryCode" : "US",
"Number": "123GHY",
"ExpirationDate": "2021-07-11"
},
"Gender": "Male",
"DateOfBirth": "1978-10-23",
"FrequentFlyerPrograms": [
{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "12345"
},
{
"MarketingCarrierCode": "BA",
"ProgramCarrierCode": "BA",
"Number": "queen1"
}
],
"TsaNumber": "12345678",
"RedressNumber": "1234567",
"SpecialAssistances": [
"BLIND_WITH_SEEING_EYE_DOG",
"WHEELCHAIR_IMMOBILE"
],
"EmergencyContact": {
"Name": {
"FirstName": "Bobby",
"LastName": "James",
"MiddleName": "Sans"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
}
},
"PassengerType": "ADULT",
"MealPreference": "Kosher",
"SeatPreference": "Window",
"Seats": [
{
"SeatNumber": "17A",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-07-27"
},
{
"SeatNumber": "20A",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-07-28"
}
]
},
{
"Primary": false,
"Name": {
"FirstName": "Mary",
"LastName": "Ann",
"MiddleName": "Edward"
},
"Gender": "Female",
"DateOfBirth": "1980-09-30",
"FrequentFlyerPrograms": [
{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "12345891"
}
],
"TsaNumber": "1234567811",
"RedressNumber": "123456711",
"SpecialAssistances": [
"NONE"
],
"PassengerType": "ADULT",
"MealPreference": "Hindu Vegetarian",
"SeatPreference": "Aisle",
"Seats": [
{
"SeatNumber": "17B",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-07-27"
},
{
"SeatNumber": "20B",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-07-28"
}
]
},
{
"Primary": false,
"Name": {
"FirstName": "Little",
"LastName": "Zhang",
"MiddleName": "Edward"
},
"Gender": "Male",
"DateOfBirth": "2007-12-10",
"FrequentFlyerPrograms": [
{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "1234589"
}
],
"TsaNumber": "12345678",
"RedressNumber": "1234567",
"SpecialAssistances": [
"NONE"
],
"PassengerType": "CHILD",
"MealPreference": "Sushi",
"SeatPreference": "Window",
"Seats": [
{
"SeatNumber": "17C",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-07-27"
},
{
"SeatNumber": "20C",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-07-28"
}
]
}
],
"FraudCheckId": "2CAAADE1R-654F-43B3-B932-EEDF8764CAA1",
"BillingDetails": {
"CreditCard": {
"CardNumber": "4XXXXXXXXXXXXXX8",
"CardType": "Visa",
"CardSecurityCode": "123",
"ExpirationMonth": "12",
"ExpirationYear": "2025"
},
"Name": {
"FirstName": "San",
"MiddleName": "Edward",
"LastName": "Test"
},
"Address": {
"Address1": "3333 108th Ave",
"Address2": "Expedia HQ",
"City": "Bellevue",
"Province": "WA",
"Country": "USA",
"PostalCode": "98004"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "425",
"Number": "1234567"
},
"TwoStepPaymentDetails": {
"PaymentType": "3DS",
"ReturnUrl": "http://www.google.com",
"PaymentSessionId": "ern:pay:pa:r1::d6d6aa02-833a-09cc-2136-d5abdd2b7344",
"MpiData": {
"Cavv": "Y2FyZGluYWxjb21tZXJjZWF1dGg=",
"Xid": "ODUzNTYzOTcwODU5NzY3Qw==",
"Eci": "05",
"CavvAlgorithm": "2",
"DsTransactionId": "1c59a512-ab4f-4370-af97-4cfe69b7276e",
"ThreeDSVersion": "2.0.1",
"MerchantName": "Expedia.com",
"PAResStatus": "Y",
"VEResStatus": "Y"
}
}
},
"AdditionalBookingDetails": {
"MarketingCode": "111abc",
"Source": "browser",
"PartnerAgentId": "123456",
"PartnerConfirmationNumber": "hello123",
"PnrRemarks": [".U*TripId-1128-test", ".U*TripId-1128-test", ".U*93-FREEBIRD-ENROLLED", "U7-US", "U9-17976"]
},
"PartnerMetaData" : {
"SampleKey1" : "SampleValue1",
"SampleKey2" : "SampleValue2"
}
}
3DS Book Request - With EG authentication
{
"Title": "My Flight Booking",
"BrowserData": {
"IpAddressV4": "216.251.118.195",
"BrowserAcceptHeader": "text/html",
"EncodedBrowserMetadata": "eyJicm93c2VySmF2YUVuYWJsZWQiOmZhbHNlLCJicm93c2VyTGFuZ3VhZ2UiOiJ6aC1DTiIsImJyb3dzZXJDb2xvckRlcHRoIjoyNCwiYnJvd3NlclNjcmVlbkhlaWdodCI6MTA4MCwiYnJvd3NlclNjcmVlbldpZHRoIjoxOTIwLCJicm93c2VyVFoiOi00ODAsImJyb3dzZXJVc2VyQWdlbnQiOiJNb3ppbGxhLzUuMCAoV2luZG93cyBOVCA2LjE7IFdpbjY0OyB4NjQpIEFwcGxlV2ViS2l0LzUzNy4zNiAoS0hUTUwsIGxpa2UgR2Vja28pIENocm9tZS83NS4wLjM3NzAuMTAwIFNhZmFyaS81MzcuMzYifQ==",
"MerchantUrl": "https://www.expedia.com/hotel"
},
"Travelers": [
{
"Primary": true,
"Name": {
"FirstName": "San",
"LastName": "Zhang",
"MiddleName": "Edward"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
},
"Email": "ewsbooking@gmail.com",
"Passport": {
"CountryCode": "US",
"Number": "123GHY",
"ExpirationDate": "2021-07-11"
},
"Gender": "Male",
"DateOfBirth": "1978-10-23",
"FrequentFlyerPrograms": [
{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "12345"
},
{
"MarketingCarrierCode": "BA",
"ProgramCarrierCode": "BA",
"Number": "queen1"
}
],
"TsaNumber": "12345678",
"RedressNumber": "1234567",
"SpecialAssistances": [
"BLIND_WITH_SEEING_EYE_DOG",
"WHEELCHAIR_IMMOBILE"
],
"EmergencyContact": {
"Name": {
"FirstName": "Bobby",
"LastName": "James",
"MiddleName": "Sans"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
}
},
"PassengerType": "ADULT",
"MealPreference": "Kosher",
"SeatPreference": "Window",
"Seats": [
{
"SeatNumber": "17A",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-07-27"
},
{
"SeatNumber": "20A",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-07-28"
}
]
},
{
"Primary": false,
"Name": {
"FirstName": "Mary",
"LastName": "Ann",
"MiddleName": "Edward"
},
"Gender": "Female",
"DateOfBirth": "1980-09-30",
"FrequentFlyerPrograms": [
{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "12345891"
}
],
"TsaNumber": "1234567811",
"RedressNumber": "123456711",
"SpecialAssistances": [
"NONE"
],
"PassengerType": "ADULT",
"MealPreference": "Hindu Vegetarian",
"SeatPreference": "Aisle",
"Seats": [
{
"SeatNumber": "17B",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-07-27"
},
{
"SeatNumber": "20B",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-07-28"
}
]
},
{
"Primary": false,
"Name": {
"FirstName": "Little",
"LastName": "Zhang",
"MiddleName": "Edward"
},
"Gender": "Male",
"DateOfBirth": "2007-12-10",
"FrequentFlyerPrograms": [
{
"MarketingCarrierCode": "VA",
"ProgramCarrierCode": "VA",
"Number": "1234589"
}
],
"TsaNumber": "12345678",
"RedressNumber": "1234567",
"SpecialAssistances": [
"NONE"
],
"PassengerType": "CHILD",
"MealPreference": "Sushi",
"SeatPreference": "Window",
"Seats": [
{
"SeatNumber": "17C",
"FlightNumber": "321",
"ArrivalAirportCode": "SFO",
"DepartureAirportCode": "BOS",
"DepartureDate": "2021-07-27"
},
{
"SeatNumber": "20C",
"FlightNumber": "456",
"ArrivalAirportCode": "BOM",
"DepartureAirportCode": "SFO",
"DepartureDate": "2021-07-28"
}
]
}
],
"FraudCheckId": "2CAAADE1R-654F-43B3-B932-EEDF8764CAA1",
"BillingDetails": {
"CreditCard": {
"CardNumber": "4XXXXXXXXXXXXXX8",
"CardType": "Visa",
"CardSecurityCode": "123",
"ExpirationMonth": "12",
"ExpirationYear": "2025"
},
"Name": {
"FirstName": "San",
"MiddleName": "Edward",
"LastName": "Test"
},
"Address": {
"Address1": "3333 108th Ave",
"Address2": "Expedia HQ",
"City": "Bellevue",
"Province": "WA",
"Country": "USA",
"PostalCode": "98004"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "425",
"Number": "1234567"
},
"TwoStepPaymentDetails": {
"PaymentType": "3DS",
"ReturnUrl": "http://www.google.com",
"PaymentSessionId": "ern:pay:pa:r1::d6d6aa02-833a-09cc-2136-d5abdd2b7344"
}
},
"AdditionalBookingDetails": {
"MarketingCode": "111abc",
"Source": "browser",
"PartnerAgentId": "123456",
"PartnerConfirmationNumber": "hello123",
"PnrRemarks": [
".U*TripId-1128-test",
".U*TripId-1128-test",
".U*93-FREEBIRD-ENROLLED",
"U7-US",
"U9-17976"
]
},
"PartnerMetaData": {
"SampleKey1": "SampleValue1",
"SampleKey2": "SampleValue2"
}
}
Example Flight Book Response
{
"TransactionId": "b5f47dff-1187-43fc-8df1-3cbe641b2226",
"ItineraryNumber": 7605955276409,
"Warnings": {
"MULTIPLE_SPECIAL_ASSISTANCE_NOT_SUPPORTED": "Booking succeeded, but only one special assistance is currently supported, so only the first one has been requested.",
"FREQUENT_FLYER_PROGRAM_NOT_REQUESTED": "Booking succeeded, but the requested Frequent Flyer Programs are either inapplicable or duplicate - {VA,VA,12345}{BA,BA,queen1}",
"FAILED_TO_RESERVE_SEAT": "Booking succeeded, but failed to reserve the requested seats due to invalid flight information."
},
"BookingDateTime": "2023-12-09T15:41:56+00:00",
"PartnerAgentId": "123456",
"PartnerConfirmationNumber": "hello123",
"Links": {
"ApiFareRules": {
"Accept": "application/vnd.exp-flight.v1+json",
"Method": "GET",
"Href": "https://apim.int.expedia.com/flights/farerules/CgVjb2FjaBoJUHVibGlzaGVkIgd1bmtub3duKgl1bml2ZXJzYWwyAlVBQk8IARIZMjAyMy0xMi0xNVQxODo0NTowMC0wODowMBoDTEFTIgNMQVgqAlVBMghLQUEwUEZCTkIGTEFYTEFTSglGYXJlbG9naXhqBUFEVUxU"
},
"WebItinRetrieve": {
"Href": "https://wwwexpediacom.integration.sb.karmalab.net/trips/7605955276409?userToken=V8wAg5RlwiUMHhP5wjAZJtTkW87kMUaY78WSUPVUQRvSx5-NMiknA6DqvHWAoLIUmwzIYGDuaIp77n1XTm_G0lDYgxTKlW7WcC_FewvKu1ZSXJSZfA"
},
"ApiItinRetrieve": {
"Accept": "application/vnd.exp-flight.v3+json",
"Method": "GET",
"Href": "https://apim.int.expedia.com/flights/bookings/7605955276409"
}
},
"AirlineConfirmations": [
{
"MarketingAirlineCode": "UA",
"ConfirmationNumber": "DR8TDP"
}
],
"Free24HourCancellation": true,
"SplitTicket": false,
"GDSLocators": [
"L9KZH5"
],
"Price": {
"TotalPrice": {
"Value": "68.90",
"Currency": "USD"
},
"BasePrice": {
"Value": "50.23",
"Currency": "USD"
},
"TotalTaxes": {
"Value": "18.67",
"Currency": "USD"
},
"TotalTaxesAndFees": {
"Value": "18.67",
"Currency": "USD"
},
"PricePerPassengerCategory": [
{
"Category": "ADULT",
"Count": 1,
"BasePrice": {
"Value": "50.23",
"Currency": "USD"
},
"TotalTaxes": {
"Value": "18.67",
"Currency": "USD"
}
}
]
},
"Travelers": [
{
"Name": {
"FirstName": "QCEFIRSTNAMEBFBACBDBETEST",
"LastName": "QCELASTNAMEEFDCDBCEBBF"
},
"Phone": {
"CountryCode": "11",
"Number": "2069876543"
},
"Email": "QCETEST1@GMAIL.COM",
"Primary": true,
"Gender": "Male",
"PassengerType": "ADULT",
"DateOfBirth": "1978-10-23",
"Passport": {
"CountryCode": "US",
"Number": "123GHY",
"ExpirationDate": "2021-06-11"
},
"Tickets": [
{
"TicketingAirlineCode": "UA",
"Refundable": false,
"RefundPenalty": {
"PreTripChange": {
"Allow": "YES",
"Penalty": {
"Value": "99.00",
"Currency": "USD"
}
},
"PreTripCancel": {
"Allow": "NO"
},
"EnrouteChange": {
"Allow": "UNKNOWN"
},
"EnrouteCancel": {
"Allow": "UNKNOWN"
},
"Transferable": "NO",
"NameChangeAllowed": "NO"
}
}
]
}
],
"Segments": [
{
"SegmentId": "Mzg4NTIwNDA4MjYyOTUwOTEyMTE=",
"FlightDuration": "PT1H16M",
"TotalStops": 0,
"DepartureArrivalDayDifference": 0,
"AirportChange": false,
"FareType": "PUBLISHED",
"BasicEconomy": true,
"Links": {
"ApiBaggageFees": {
"Accept": "application/vnd.exp-flight.v1+json",
"Method": "GET",
"Href": "https://apim.int.expedia.com/flights/baggagefees/CkYKAlVBEgJVQRoKMjAyMy0xMi0xNSIDTEFYKgoyMDIzLTEyLTE1MgNMQVM6AU5CCEtBQTBQRkJOSgdFQ09OT01ZUgQyMTgxEgNVU0QaAmtn"
}
},
"Legs": [
{
"StatusCode": "HK",
"DepartureAirport": {
"Code": "LAX",
"Name": "Los Angeles Intl.",
"City": "Los Angeles",
"Province": "CA",
"Country": "USA",
"Latitude": "33.94415",
"Longitude": "-118.4032"
},
"ArrivalAirport": {
"Code": "LAS",
"Name": "Harry Reid Intl.",
"City": "Las Vegas",
"Province": "NV",
"Country": "USA",
"Latitude": "36.085393",
"Longitude": "-115.150098"
},
"DepartureDateTime": "2023-12-15T18:45:00-08:00",
"ArrivalDateTime": "2023-12-15T20:01:00-08:00",
"FlightNumber": "2181",
"MarketingAirlineCode": "UA",
"MarketingAirlineName": "United",
"OperatingAirlineCode": "UA",
"OperatingAirlineName": "United",
"EquipmentCode": "739",
"EquipmentName": "Boeing 737-900",
"FlightDuration": "PT1H16M",
"FlightDistance": {
"Value": "241",
"Unit": "MI"
},
"BookingCode": "N",
"CabinClass": "ECONOMY",
"EquipmentChange": false,
"AirlineConfirmation": {
"MarketingAirlineCode": "UA",
"ConfirmationNumber": "DR8TDP"
},
"GDSLocator": "L9KZH5",
"FareBasisCode": "KAA0PFBN"
}
]
}
],
"PnrRemarks": [
".U*TripId-hello123"
],
"FareOptions": [
{
"FareName": "Basic Economy",
"SegmentIds": [
"Mzg4NTIwNDA4MjYyOTUwOTEyMTE="
],
"NotAvailable": [
"SEAT_CHOICE",
"MEALS",
"CHANGES",
"CANCELLATION"
],
"RestrictedFare": false
}
]
}
Example Price Change Error Response (Price Increase)
{
"Errors": [
{
"Code": "PRICE_INCREASE",
"Description": "The price for your trip has changed from 4.90 USD to 83.90 USD.",
"OriginalPrice": {
"Value": "4.9",
"Currency": "USD"
},
"NewPrice": {
"Value": "83.9",
"Currency": "USD"
},
"ChangedAmount": {
"Value": "79.00",
"Currency": "USD"
},
"Links": {
"ApiBook": {
"Accept": "application/vnd.exp-flight.v3+json",
"Method": "POST",
"Href": "http://127.0.0.1:8080/flights/bookings/d34b8ab5adaa4e14add4b4fa6c97d222-0-1~2.D~AQoECL-kBBIICNQEEAEYwB8gASgCWAFwAA~AQoiCiAIwmwSAzg4MBiLuAEgi5ABKP3EvwIwxsW_AjhMQABYARIMCAEQARgBKgJCNjIAGAEiBAgBEAEoAigDKAQwAg?price=83.90¤cy=USD"
}
},
"Price": {
"TotalPrice": {
"Value": "83.90",
"Currency": "USD"
},
"BasePrice": {
"Value": "27.91",
"Currency": "USD"
},
"TotalTaxes": {
"Value": "16.99",
"Currency": "USD"
},
"TotalTaxesAndFees": {
"Value": "55.99",
"Currency": "USD"
},
"AveragePricePerTicket": {
"Value": "83.9",
"Currency": "USD",
"Count": 1
},
"PricePerPassengerCategory": [
{
"Category": "ADULT",
"Count": 1,
"BasePrice": {
"Value": "27.91",
"Currency": "USD"
},
"TotalTaxes": {
"Value": "16.99",
"Currency": "USD"
},
"Fees": [
{
"Value": "39.0",
"Currency": "USD",
"Name": "TeleSales"
}
]
}
]
}
}
],
"TransactionId": "c9736f11-694c-41e9-8375-5220fb41d6c1"
}
Example Price Change Error Response (Price Decrease)
{
"Errors": [
{
"Code": "PRICE_DECREASE",
"Description": "The price for your trip has changed from 167.80 USD to 167.80 USD.",
"OriginalPrice": {
"Value": "167.8",
"Currency": "USD"
},
"NewPrice": {
"Value": "167.8",
"Currency": "USD"
},
"ChangedAmount": {
"Value": "0.00",
"Currency": "USD"
},
"Links": {
"ApiBook": {
"Accept": "application/vnd.exp-flight.v3+json",
"Method": "POST",
"Href": "http://127.0.0.1:8080/flights/bookings/dd283e4a43bb4e7cb8f7ae007bac0931-0-1~2.D~AQoECL-kBBIICNQEEAEYwB8gASgCWAFwAA~AQojCiEIwmwSBDEwODAYi7gBIIuQASisyr8CMPXKvwI4TEAAWAESDAgBEAEYASoCQjYyABgCIgQIARABIgQIAhABKAIoAygEMAI?price=167.80¤cy=USD"
}
},
"Price": {
"TotalPrice": {
"Value": "167.80",
"Currency": "USD"
},
"BasePrice": {
"Value": "55.82",
"Currency": "USD"
},
"TotalTaxes": {
"Value": "33.98",
"Currency": "USD"
},
"TotalTaxesAndFees": {
"Value": "111.98",
"Currency": "USD"
},
"AveragePricePerTicket": {
"Value": "83.9",
"Currency": "USD",
"Count": 2
},
"PricePerPassengerCategory": [
{
"Category": "ADULT",
"Count": 1,
"BasePrice": {
"Value": "27.91",
"Currency": "USD"
},
"TotalTaxes": {
"Value": "16.99",
"Currency": "USD"
},
"Fees": [
{
"Value": "39.0",
"Currency": "USD",
"Name": "TeleSales"
}
]
},
{
"Category": "CHILD",
"Count": 1,
"BasePrice": {
"Value": "27.91",
"Currency": "USD"
},
"TotalTaxes": {
"Value": "16.99",
"Currency": "USD"
},
"Fees": [
{
"Value": "39.0",
"Currency": "USD",
"Name": "TeleSales"
}
]
}
]
}
}
],
"TransactionId": "faa71f00-ac95-464e-bf23-0933cdfd7425"
}
Example Flight Book Response (with Airport Lounge Information)
. . .
"Lounges": {
"B6LOUNGE": [{
"Name": "The B6 Lounge",
"IsConferenceRoomAvailable": false,
"PhoneNumber": "N/A",
"Description": "Terminal 3 near Gate 74, 5 am \u0096 11 pm"
}]
}
}
Error Codes
Warning Code
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.