Package Booking API

Guidance and examples for accessing the Package 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 Package Booking API allows you to enable booking of up to 6 travelers within a single package.

Endpoint

MethodEndpointPrerequisites
POSThttps://apim.expedia.com/packages/bookings/[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-package.v3+json
Content-Type:application/json
User-Id:username@domain.com

The email address associated with the booking and to which the Booking Confirmation Email will be sent.
Partner-Transaction-Id:Partner TransactionID String

Required Headers

Accept-Encoding:gzip

More info on gzip

Next Steps

  • Get baggage details of each flight selected via Baggage Fee API.
  • Retrieve the booking details via the Package Itinerary Retrieve API.

Example of Packages Booking Request

Packages Booking Request URL

https://apim.expedia.com/packages/bookings/CosFdjUtYmIzOWY0ODUzZDE0NGFkMmJjMjBlYmE3ZDUyNGIzMjAtMS01LTF-MC5TfkFRb0NDQUVTQndqVUJCQUJHQUVnQVNBTUlBY2dEU2dEVWdtLVF3R0FUQUhXV0FFfkFRcG9DaDhJd2FZQkVnTTRNekFZcDFzZ3NoSW9xYWlEQVREZ3FvTUJPRlJBQUZnQkNpRUl3YVlCRWdReU5qVXhHTElTSUl1NEFTaWhyb01CTVAydWd3RTRVa0FBV0FFS0lnakJwZ0VTQkRFME9ESVlpN2dCSUl1UUFTalRzb01CTUphemd3RTRWRUFBV0FFS1JRb2hDTUdtQVJJRU1Ua3dOUmlMa0FFZ3NuRW80dE9EQVREQjFJTUJPRlJBQUZnQkNpQUl3YVlCRWdReE1EVXhHTEp4SUtkYktKclZnd0V3anRpREFUaFNRQUJZQVJJS0NBRVFBUmdCS2dKQlV4Z0JJZ1FJQVJBQktBUW9BeWdCS0FJd0FnK0FRcG9DaDhJd2FZQkVnTTRNekFZcDFzZ3NoSW9xYWlEQVREZ3FvTUJPRlJBQUZnQkNpRUl3YVlCRWdReU5qVXhHTElTSUl1NEFTaWhyb01CTVAydWd3RTRVa0FBV0FFS0lnakJwZ0VTQkRFME9ESVlpN2dCSUl1UUFTalRzb01CTUphemd3RTRWRUFBV0FFS1JRb2hDTUdtQVJJRU1Ua3dOUmlMa0FFZ3NuRW80dE9EQVREQjFJTUJPRlJBQUZnQkNpQUl3YVlCRWdReE1EVXhHTEp4SUtkYktKclZnd0V3anRpREFUaFNRQUJZQVJJS0NBRVFBUmdCS2dKQlV4Z0JJZ1FJQVJBQktBUW9BeWdCS0FJd0FnElxDZ2d4TmpReU56YzJPQkl5Q2dreU1ERTRNVGswTURZU0NUSXdPVEkwTmpJNE1Cb0NNalFxQ2pJd01UZ3RNREl0TURNeUNqSXdNVGd0TURJdE1EWVlBU29EQ2dFeA?price=936.37&currency=USD

Packages Booking Request Body

{
	"Title": "My Package Booking",
	"Flight": {
		"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": "HA",
					"ProgramCarrierCode": "HA",
					"Number": "12345"
				},
				{
					"MarketingCarrierCode": "BA",
					"ProgramCarrierCode": "BA",
					"Number": "queen1"
				}
			],
			"TsaNumber": "12345678",
			"RedressNumber": "1234567",
			"EmergencyContact": {
				"Name": {
					"FirstName": "Bobby",
					"LastName": "James",
					"MiddleName": "Jones"
				},
				"Phone": {
					"CountryCode": "1",
					"AreaCode": "206",
					"Number": "9876543"
				}
			},
			"PassengerType": "ADULT",
			"MealPreference": "Kosher",
			"SeatPreference": "Window"
		}]
	},
	"Hotel": {
		"RoomDetails": [{
			"Traveler": {
				"Primary": true,
				"Name": {
					"FirstName": "John",
					"LastName": "Doe",
					"MiddleName": "Edward"
				},
				"Phone": {
					"CountryCode": "1",
					"AreaCode": "206",
					"Number": "9876543"
				},
				"Email": "john.doe@gmail.com"
			},
			"RoomPreferences": [{
					"Type": "SmokingPreference",
					"Value": "NonSmoking"
				},
				{
					"Type": "Bed",
					"Value": "4"
				}
			],
			"SpecialRequests": "check-in 2 hours late,Crib Required"
		}]
	},
	"FraudCheckId": "a9e371c4-89d9-4f9c-8df7-df105830e7fe",
	"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",
		"PartnerAgentId": "123456",
		"PartnerConfirmationNumber": "hello123",
		"HotelLoyalty": {
			"Type": "AB",
			"Number": "12345"
		}
	},
    "PartnerMetaData": {
      "SampleKey1": "SampleValue1",
      "SampleKey2": "SampleValue2"
  }
}

3DS Book Request

EWS supports 2 ways for 3ds:

  1. 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.
  2. 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 Package Booking",
  "Flight": {
    "Travelers": [
      {
        "Primary": true,
        "Name": {
          "FirstName": "San",
          "LastName": "Zhang",
          "MiddleName": "Edward"
        },
        "Phone": {
          "CountryCode": "1",
          "AreaCode": "206",
          "Number": "9876543"
        },
        "Email": "San.Zhang@gmail.com",
        "Passport": {
          "CountryCode": "US",
          "Number": "123GHY",
          "ExpirationDate": "2021-11-11"
        },
        "Gender": "Male",
        "DateOfBirth": "1978-10-23",
        "FrequentFlyerPrograms": [
          {
            "MarketingCarrierCode": "HA",
            "ProgramCarrierCode": "HA",
            "Number": "12345"
          },
          {
            "MarketingCarrierCode": "BA",
            "ProgramCarrierCode": "BA",
            "Number": "queen1"
          }
        ],
        "TsaNumber": "12345678",
        "RedressNumber": "1234567",
        "EmergencyContact": {
          "Name": {
            "FirstName": "Bobby",
            "LastName": "James",
            "MiddleName": "Jones"
          },
          "Phone": {
            "CountryCode": "1",
            "AreaCode": "206",
            "Number": "9876543"
          }
        },
        "PassengerType": "ADULT",
        "MealPreference": "Kosher",
        "SeatPreference": "Window"
      }
    ]
  },
  "Hotel": {
    "RoomDetails": [
      {
        "Traveler": {
          "Primary": true,
          "Name": {
            "FirstName": "San",
            "LastName": "Zhang",
            "MiddleName": "Edward"
          },
          "Phone": {
            "CountryCode": "1",
            "AreaCode": "206",
            "Number": "9876543"
          },
          "Email": "San.Zhang@gmail.com"
        },
        "RoomPreferences": [
          {
            "Type": "SmokingPreference",
            "Value": "NonSmoking"
          },
          {
            "Type": "Bed",
            "Value": "4"
          }
        ],
        "SpecialRequests": "check-in 2 hours late,Crib Required"
      }
    ]
  },
  "FraudCheckId": "a9e371c4-89d9-4f9c-8df7-df105830e7fe",
  "BillingDetails": {
    "CreditCard": {
      "CardNumber": "520000XXXXX00007",
      "CardType": "MasterCard",
      "CardSecurityCode": "111",
      "ExpirationMonth": "12",
      "ExpirationYear": "2025"
    },
    "Name": {
      "FirstName": "San",
      "MiddleName": "Edward",
      "LastName": "Zhang"
    },
    "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",
    "PartnerAgentId": "123456",
    "PartnerConfirmationNumber": "hello123",
    "HotelLoyalty": {
      "Type": "AB",
      "Number": "12345"
    }
  },
  "PartnerMetaData": {
    "SampleKey1": "SampleValue1",
    "SampleKey2": "SampleValue2"
  }
}

3DS Book Request - With EG authentication

{
  "Title": "My Package Booking",
  "BrowserData": {
    "IpAddressV4": "216.251.118.195",
    "BrowserAcceptHeader": "text/html",
    "EncodedBrowserMetadata": "eyJicm93c2VySmF2YUVuYWJsZWQiOmZhbHNlLCJicm93c2VyTGFuZ3VhZ2UiOiJ6aC1DTiIsImJyb3dzZXJDb2xvckRlcHRoIjoyNCwiYnJvd3NlclNjcmVlbkhlaWdodCI6MTA4MCwiYnJvd3NlclNjcmVlbldpZHRoIjoxOTIwLCJicm93c2VyVFoiOi00ODAsImJyb3dzZXJVc2VyQWdlbnQiOiJNb3ppbGxhLzUuMCAoV2luZG93cyBOVCA2LjE7IFdpbjY0OyB4NjQpIEFwcGxlV2ViS2l0LzUzNy4zNiAoS0hUTUwsIGxpa2UgR2Vja28pIENocm9tZS83NS4wLjM3NzAuMTAwIFNhZmFyaS81MzcuMzYifQ==",
    "MerchantUrl": "https://www.expedia.com/hotel"
  },
  "Flight": {
    "Travelers": [
      {
        "Primary": true,
        "Name": {
          "FirstName": "San",
          "LastName": "Zhang",
          "MiddleName": "Edward"
        },
        "Phone": {
          "CountryCode": "1",
          "AreaCode": "206",
          "Number": "9876543"
        },
        "Email": "San.Zhang@gmail.com",
        "Passport": {
          "CountryCode": "US",
          "Number": "123GHY",
          "ExpirationDate": "2021-11-11"
        },
        "Gender": "Male",
        "DateOfBirth": "1978-10-23",
        "FrequentFlyerPrograms": [
          {
            "MarketingCarrierCode": "HA",
            "ProgramCarrierCode": "HA",
            "Number": "12345"
          },
          {
            "MarketingCarrierCode": "BA",
            "ProgramCarrierCode": "BA",
            "Number": "queen1"
          }
        ],
        "TsaNumber": "12345678",
        "RedressNumber": "1234567",
        "EmergencyContact": {
          "Name": {
            "FirstName": "Bobby",
            "LastName": "James",
            "MiddleName": "Jones"
          },
          "Phone": {
            "CountryCode": "1",
            "AreaCode": "206",
            "Number": "9876543"
          }
        },
        "PassengerType": "ADULT",
        "MealPreference": "Kosher",
        "SeatPreference": "Window"
      }
    ]
  },
  "Hotel": {
    "RoomDetails": [
      {
        "Traveler": {
          "Primary": true,
          "Name": {
            "FirstName": "San",
            "LastName": "Zhang",
            "MiddleName": "Edward"
          },
          "Phone": {
            "CountryCode": "1",
            "AreaCode": "206",
            "Number": "9876543"
          },
          "Email": "San.Zhang@gmail.com"
        },
        "RoomPreferences": [
          {
            "Type": "SmokingPreference",
            "Value": "NonSmoking"
          },
          {
            "Type": "Bed",
            "Value": "4"
          }
        ],
        "SpecialRequests": "check-in 2 hours late,Crib Required"
      }
    ]
  },
  "FraudCheckId": "a9e371c4-89d9-4f9c-8df7-df105830e7fe",
  "BillingDetails": {
    "CreditCard": {
      "CardNumber": "520000XXXXX00007",
      "CardType": "MasterCard",
      "CardSecurityCode": "111",
      "ExpirationMonth": "12",
      "ExpirationYear": "2025"
    },
    "Name": {
      "FirstName": "San",
      "MiddleName": "Edward",
      "LastName": "Zhang"
    },
    "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",
    "PartnerAgentId": "123456",
    "PartnerConfirmationNumber": "hello123",
    "HotelLoyalty": {
      "Type": "AB",
      "Number": "12345"
    }
  },
  "PartnerMetaData": {
    "SampleKey1": "SampleValue1",
    "SampleKey2": "SampleValue2"
  }
}

Packages Booking Response

{
    "TransactionId": "a4b0b5c9-2629-425a-9dcd-2747dfd2b72f",
    "ItineraryNumber": 7608273722851,
    "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": "2024-11-11T07:05:12+00:00",
    "PartnerAgentId": "123456",
    "PartnerConfirmationNumber": "hello123",
    "Links": {
        "WebItinRetrieve": {
            "Href": "https://wwwmytravelchatcom.integration.sb.karmalab.net/trips/7608273722851?userToken=zOxRgWtKThkSq1nfmg3KBhpNEA2kfj46O-hrr26sx_JVNTuZ3X2ltmuwPmPfJ7HXLKApDwf-S1YOC3nujJndeSE3xN8npCmNUouWoMXLXEg"
        },
        "ApiItinRetrieve": {
            "Accept": "application/vnd.exp-package.v3+json",
            "Method": "GET",
            "Href": "http://127.0.0.1:8080/packages/bookings/7608273722851"
        }
    },
    "AirlineConfirmations": [
        {
            "MarketingAirlineCode": "AS",
            "ConfirmationNumber": "TFVXUK"
        }
    ],
    "GDSLocators": [
        "QZOGSD"
    ],
    "HotelConfirmation": "9030334548576",
    "NumberOfRooms": 1,
    "Price": {
        "PackageBasePrice": {
            "Value": "526.88",
            "Currency": "USD"
        },
        "PackageTotalPrice": {
            "Value": "636.09",
            "Currency": "USD"
        },
        "PackageTaxesAndFees": {
            "Value": "109.21",
            "Currency": "USD"
        },
        "AverageCostPerPerson": {
            "Value": "636.09",
            "Currency": "USD"
        }
    },
    "Hotel": {
        "Id": "14405",
        "Rooms": [
            {
                "Traveler": {
                    "Name": {
                        "FirstName": "VVV",
                        "MiddleName": "Edwarda",
                        "LastName": "Doea"
                    },
                    "Phone": {
                        "CountryCode": "1",
                        "AreaCode": "206",
                        "Number": "9876543"
                    },
                    "Email": "San.doe@gmail.com"
                },
                "RoomPreferences": [
                    {
                        "Type": "SmokingPreference",
                        "Value": "NonSmoking"
                    }
                ],
                "SpecialRequests": "check-in 2 hours late,Crib Required",
                "Occupants": [
                    {
                        "Adults": 1
                    }
                ],
                "StayDates": [
                    {
                        "CheckInDate": "2025-03-21",
                        "CheckOutDate": "2025-03-23"
                    }
                ],
                "RatePlanType": "standalone",
                "RatePlans": [
                    {
                        "RoomTypeId": "318419692",
                        "RatePlanId": "381626027",
                        "RateRuleId": "723555617",
                        "StayDates": {
                            "CheckInDate": "2025-03-21",
                            "CheckOutDate": "2025-03-23"
                        },
                        "ConfirmationNumber": "2be798fc-57cf-4082-bbaa-a8f5e78fe2a3"
                    }
                ],
                "SmokingOption": "NonSmoking"
            }
        ]
    },
    "Flight": {
        "Travelers": [
            {
                "Name": {
                    "FirstName": "VVV",
                    "MiddleName": "Edwarda",
                    "LastName": "Doea"
                },
                "Phone": {
                    "CountryCode": "1",
                    "AreaCode": "206",
                    "Number": "9876543"
                },
                "Email": "San.doe@gmail.com",
                "Gender": "Male",
                "PassengerType": "ADULT",
                "DateOfBirth": "1978-10-23",
                "Passport": {
                    "CountryCode": "US",
                    "Number": "123GHY",
                    "ExpirationDate": "2017-11-11"
                },
                "Tickets": [
                    {
                        "Refundable": false,
                        "RefundPenalty": {
                            "PreTripChange": {
                                "Allow": "NO"
                            },
                            "PreTripCancel": {
                                "Allow": "NO"
                            },
                            "EnrouteChange": {
                                "Allow": "NO"
                            },
                            "EnrouteCancel": {
                                "Allow": "NO"
                            },
                            "Transferable": "NO",
                            "NameChangeAllowed": "NO"
                        }
                    }
                ]
            }
        ],
        "Free24HourCancellation": true
    }
}

Packages Booking Response - More Details

{
	"TransactionId": "4b8a53a5-248a-429f-a437-4e005a160edf",
	"ItineraryNumber": 79010381654,
	"PartnerAgentId": "123456",
	"PartnerConfirmationNumber": "hello123",
	"Warnings": {
		"102": "Booking succeeded, but the requested Frequent Flyer Programs are either inapplicable or duplicate - {BA,BA,queen1}"
	},
	"BookingDateTime": "2021-06-29T11:46:56-07:00",
	"AirlineConfirmations": [{
		"MarketingAirlineCode": "HA",
		"ConfirmationNumber": "Unassigned"
	}],
	"GDSLocators": [
		"BUXYOV"
	],
	"HotelConfirmation": "8082279258335",
	"NumberOfRooms": 1,
	"Price": {
		"PackageBasePrice": {
			"Value": "975.43",
			"Currency": "USD"
		},
		"PackageTotalPrice": {
			"Value": "1072.69",
			"Currency": "USD"
		},
		"PackageTaxesAndFees": {
			"Value": "97.26",
			"Currency": "USD"
		},
		"TotalHotelMandatoryFees": {
			"Value": "95.25",
			"Currency": "USD"
		},
		"AverageCostPerPerson": {
			"Value": "1072.69",
			"Currency": "USD"
		},
		"HotelMandatoryFeesDetail": [{
			"Type": "ResortFee_Amt",
			"Amount": {
				"Value": "95.25",
				"Currency": "USD"
			}
		}]
	},
	"Hotel": {
		"Id": "16427768",
		"Name": "Lucky Dragon Las Vegas",
		"LocalCurrencyCode": "USD",
		"Location": {
			"Address": {
				"Address1": "300 W Sahara Ave",
				"City": "Las Vegas",
				"Province": "NV",
				"Country": "USA",
				"PostalCode": "89102"
			},
			"GeoLocation": {
				"Latitude": "36.14409",
				"Longitude": "-115.16078"
			}
		},
		"ThumbnailUrl": "https://images.trvl-media.com/hotels/17000000/16430000/16427800/16427768/c124cce7_t.jpg",
		"StarRating": "4.0",
		"HotelAmenities": [{
				"Id": "2112",
				"Name": "Casino"
			},
			{
				"Id": "2529",
				"Name": "Area shuttle (surcharge)"
			},
			{
				"Id": "2017",
				"Name": "Spa services on site"
			},
			{
				"Id": "3",
				"Name": "Bar/lounge"
			},
			{
				"Id": "4003",
				"Name": "Luggage storage"
			},
			{
				"Id": "1073742791",
				"Name": "Newspapers in lobby (surcharge)"
			},
			{
				"Id": "43",
				"Name": "Concierge services"
			},
			{
				"Id": "400",
				"Name": "Poolside bar"
			},
			{
				"Id": "2065",
				"Name": "Business center"
			},
			{
				"Id": "2387",
				"Name": "Tours/ticket assistance"
			},
			{
				"Id": "2131",
				"Name": "Meeting rooms"
			},
			{
				"Id": "19",
				"Name": "Restaurant"
			},
			{
				"Id": "2515",
				"Name": "Year Built2016"
			},
			{
				"Id": "52",
				"Name": "Total number of rooms - 203"
			},
			{
				"Id": "2004",
				"Name": "Coffee shop or café"
			},
			{
				"Id": "3861",
				"Name": "Free self parking"
			},
			{
				"Id": "2070",
				"Name": "Dry cleaning/laundry service"
			},
			{
				"Id": "2390",
				"Name": "Free WiFi"
			},
			{
				"Id": "3863",
				"Name": "Free valet parking"
			},
			{
				"Id": "24",
				"Name": "Outdoor pool"
			},
			{
				"Id": "2138",
				"Name": "Outdoor seasonal pool"
			}
		],
		"Rooms": [{
			"Traveler": {
				"Name": {
					"FirstName": "John",
					"MiddleName": "Edward",
					"LastName": "Doe"
				},
				"Phone": {
					"CountryCode": "1",
					"AreaCode": "206",
					"Number": "9876543"
				},
				"Email": "john.doe@gmail.com"
			},
			"RoomPreferences": [{
					"Type": "SmokingPreference",
					"Value": "SmokingOrNonSmoking"
				},
				{
					"Type": "Bed",
					"Value": "47"
				}
			],
			"SpecialRequests": "check-in 2 hours late,Crib Required",
			"Occupants": [{
				"Adults": 1
			}],
			"StayDates": [{
				"CheckInDate": "2021-06-03",
				"CheckOutDate": "2021-06-06"
			}],
			"Description": "Double Room",
			"RatePlans": [{
				"RoomTypeId": "201819406",
				"RatePlanId": "209246280",
				"RateRuleId": "224598154",
				"InventorySourceId": "24",
				"InventorySourceCode": "expe",
				"StayDates": {
					"CheckInDate": "2021-06-03",
					"CheckOutDate": "2021-06-06"
				},
				"PaymentMethod": "Online",
				"Amenities": [{
						"Id": "1073742787",
						"Name": "Free Internet"
					},
					{
						"Id": "2109",
						"Name": "Free Parking"
					}
				],
				"CancellationPolicy": {
                  "Refundable": true,
                  "FreeCancellation": true,
                  "FreeCancellationEndDateTime": "2021-09-25T18:00:00-10:00",
                  "CancellationPenaltyRules": [
                    {
                      "PenaltyNightCount": 2,
                      "PenaltyStartDateTime": "2021-09-25T18:00:00-10:00",
                      "PenaltyEndDateTime": "2021-09-29T18:00:00-10:00"
                    }
                  ],
                  "CancelPolicyDescription": "Cancellations or changes made after 18:00 (hotel local time) on September 25, 2021 or no-shows are subject to a property fee equal to the first and second nights rates plus taxes and fees."
                 },
				"ConfirmationNumber": "49167704-0022-4943-913c-d5828998eecf"
			}],
			"SmokingOption": "SmokingOrNonSmoking",
			"Amenities": [{
					"Id": "4948",
					"Name": "Free cribs/infant beds"
				},
				{
					"Id": "4343",
					"Name": "Wheelchair accessible"
				},
				{
					"Id": "1073742840",
					"Name": "Rollaway/extra beds (free)"
				},
				{
					"Id": "4093",
					"Name": "Square feet -415"
				}
			]
		}]
	},
	"Flight": {
		"Travelers": [{
			"Name": {
				"FirstName": "John",
				"MiddleName": "Edward",
				"LastName": "Doe"
			},
			"Phone": {
				"CountryCode": "1",
				"AreaCode": "206",
				"Number": "9876543"
			},
			"Email": "john.doe@gmail.com",
			"Primary": true,
			"Gender": "Male",
			"PassengerType": "ADULT",
			"DateOfBirth": "1978-10-23",
			"Passport": {
				"CountryCode": "US",
				"Number": "123GHY",
				"ExpirationDate": "2021-06-11"
			},
			"FrequentFlyerPrograms": [{
				"MarketingCarrierCode": "HA",
				"ProgramCarrierCode": "HA",
				"Number": "12345",
				"Status": "Frequent flyer requests should be confirmed directly with the airline"
			}],
        "TicketingAirlineCode": "UA",
            "Refundable": false,
            "RefundPenalty": {
              "PreTripChange": {
                "Allow": "YES",
                "Penalty": {
                  "Value": "0.00",
                  "Currency": "USD"
                }
              },
              "PreTripCancel": {
                "Allow": "NO"
              },
              "EnrouteChange": {
                "Allow": "YES",
                "Penalty": {
                  "Value": "0.00",
                  "Currency": "USD"
                }
              },
              "EnrouteCancel": {
                "Allow": "NO"
              },
              "Transferable": "NO",
              "NameChangeAllowed": "NO"
            }
          }
        ]
		}],
		"Segments": [{
		        "SegmentId": "MzkwNDkwNzUzNDA0NTgxODg4MTE=",
				"FlightDuration": "PT5H35M",
				"TotalStops": 0,
				"DepartureArrivalDayDifference": 1,
				"AirportChange": false,
				"FareType": "NET",
				"AccountCode": "123ab",
                "BasicEconomy": false,
				"Links": {
					"ApiBaggageFees": {
						"Accept": "application/vnd.exp-flight.v1+json",
						"Method": "GET",
						"Href": "http://apim.expedia.com/flights/baggagefees/Cj0KAkhBGgoyMDE4LTAyLTAyIgNITkwqCjIwMTgtMDItMDMyA0xBUzoBTUIGTUxXME9XSgdFQ09OT01ZUgE4EgNVU0QaAmtn"
					}
				},
				"Legs": [{
				    "StatusCode": "HK",
					"DepartureAirport": {
						"Code": "HNL",
						"Name": "Daniel K. Inouye Intl.",
						"City": "Honolulu",
						"Province": "Hawaii",
						"Country": "USA",
						"Latitude": "21.332544",
						"Longitude": "-157.919701"
					},
					"ArrivalAirport": {
						"Code": "LAS",
						"Name": "McCarran Intl.",
						"City": "Las Vegas",
						"Province": "Nevada",
						"Country": "USA",
						"Latitude": "36.085393",
						"Longitude": "-115.150098"
					},
					"DepartureDateTime": "2021-06-02T22:55:00-10:00",
					"ArrivalDateTime": "2021-06-03T06:30:00-08:00",
					"FlightNumber": "8",
					"MarketingAirlineCode": "HA",
					"MarketingAirlineName": "Hawaiian Airlines",
					"EquipmentCode": "332",
					"EquipmentName": "Airbus A330-200",
					"FlightDuration": "PT5H35M",
					"FareBasisCode": "T21DVN5",
					"BookingCode": "M",
					"CabinClass": "ECONOMY",
					"EquipmentChange": false,
					"AirlineConfirmation": {
						"MarketingAirlineCode": "HA",
						"ConfirmationNumber": "Unassigned"
					},
					"GDSLocator": "PYNMH4"
				}]
			},
			{
				"FlightDuration": "PT6H45M",
				"TotalStops": 0,
				"DepartureArrivalDayDifference": 0,
				"AirportChange": false,
				"FareType": "NET",
				"Links": {
					"ApiBaggageFees": {
						"Accept": "application/vnd.exp-flight.v1+json",
						"Method": "GET",
						"Href": "http://apim.expedia.com/flights/baggagefees/Cj0KAkhBGgoyMDE4LTAyLTA2IgNMQVMqCjIwMTgtMDItMDYyA0hOTDoBSUIGSUxYME9XSgdFQ09OT01ZUgE1EgNVU0QaAmtn"
					}
				},
				"Legs": [{
					"DepartureAirport": {
						"Code": "LAS",
						"Name": "McCarran Intl.",
						"City": "Las Vegas",
						"Province": "Nevada",
						"Country": "USA",
						"Latitude": "36.085393",
						"Longitude": "-115.150098"
					},
					"ArrivalAirport": {
						"Code": "HNL",
						"Name": "Daniel K. Inouye Intl.",
						"City": "Honolulu",
						"Province": "Hawaii",
						"Country": "USA",
						"Latitude": "21.332544",
						"Longitude": "-157.919701"
					},
					"DepartureDateTime": "2021-06-06T17:05:00-08:00",
					"ArrivalDateTime": "2021-06-06T21:50:00-10:00",
					"FlightNumber": "5",
					"MarketingAirlineCode": "HA",
					"MarketingAirlineName": "Hawaiian Airlines",
					"EquipmentCode": "332",
					"EquipmentName": "Airbus A330-200",
					"FareBasisCode": "T21DVN5",
					"FlightDuration": "PT6H45M",
					"BookingCode": "I",
					"CabinClass": "ECONOMY",
					"EquipmentChange": false,
					"AirlineConfirmation": {
						"MarketingAirlineCode": "HA",
						"ConfirmationNumber": "Unassigned"
					},
					"GDSLocator": "PYNMH4"
				}]
			}
		],
		"Links": {
			"ApiFareRules": {
				"Accept": "application/vnd.exp-flight.v1+json",
				"Method": "GET",
				"Href": "http://apim.expedia.com/flights/farerules/CgVjb2FjaBoLUGFja2FnZSBOZXQiDmF0cGNvIHNlY3VyYXRlKgdwYWNrYWdlMgJIQUJLCAESEzIwMTgtMDItMDJUMDY6MDI6MDAaA0xBUyIDSE5MKgJIQTIGTUxXME9XSgdVbmtub3duYhMxNjAxLTAxLTAxVDAwOjAwOjAwQksIAhITMjAxOC0wMi0wMlQwNjowMjowMBoDTEFTIgNITkwqAkhBMgZJTFgwT1dKB1Vua25vd25iEzE2MDEtMDEtMDFUMDA6MDA6MDA"
			}
		},
		"Free24HourCancellation": true
	},
	"Links": {
		"WebItinRetrieve": {
			"Href": "https://www.expedia.com/trips/79010381654?userToken="
		},
		"ApiItinRetrieve": {
			"Accept": "application/vnd.exp-package.v3+json",
			"Method": "GET",
			"Href": "https://apim.expedia.com/packages/bookings/79010381654"
		}
	}
}

Packages Booking with Service Fee

Packages Booking with Service Fee - Request Body

{
	"Title": "My Package Booking",
	"Flight": {
		"WaiveServiceFee": false,
		"Travelers": [{
			"Primary": true,
			"Name": {
				"FirstName": "John",
				"LastName": "Test",
				"MiddleName": "Edward"
			},
			"Phone": {
				"CountryCode": "1",
				"AreaCode": "206",
				"Number": "9876543"
			},
			"Email": "v-sujsukumaran@expedia.com",
			"Passport": {
				"CountryCode": "US",
				"Number": "123GHY",
				"ExpirationDate": "2021-06-11"
			},
			"Gender": "Male",
			"DateOfBirth": "1978-10-23",
			"FrequentFlyerPrograms": [{
					"MarketingCarrierCode": "HA",
					"ProgramCarrierCode": "HA",
					"Number": "12345"
				},
				{
					"MarketingCarrierCode": "BA",
					"ProgramCarrierCode": "BA",
					"Number": "queen1"
				}
			],
			"TsaNumber": "12345678",
			"RedressNumber": "1234567",
			"EmergencyContact": {
				"Name": {
					"FirstName": "Bobby",
					"LastName": "James",
					"MiddleName": "Jones"
				},
				"Phone": {
					"CountryCode": "1",
					"AreaCode": "206",
					"Number": "9876543"
				}
			},
			"PassengerType": "ADULT",
			"MealPreference": "Kosher",
			"SeatPreference": "Window"
		}]
	},
	"Hotel": {
		"RoomDetails": [{
			"Traveler": {
				"Primary": true,
				"Name": {
					"FirstName": "John",
					"LastName": "Doe",
					"MiddleName": "Edward"
				},
				"Phone": {
					"CountryCode": "1",
					"AreaCode": "206",
					"Number": "9876543"
				},
				"Email": "v-ryezzu@expedia.com"
			},
			"RoomPreferences": [{
					"Type": "SmokingPreference",
					"Value": "NonSmoking"
				},
				{
					"Type": "Bed",
					"Value": "4"
				}
			],
			"SpecialRequests": "check-in 2 hours late,Crib Required"
		}]
	},
	"FraudCheckId": "a9e371c4-89d9-4f9c-8df7-df105830e7fe",
	"BillingDetails": {
		"CreditCard": {
			"CardNumber": "***************8",
			"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",
		"PartnerAgentId": "123456",
		"PartnerConfirmationNumber": "hello123",
		"HotelLoyalty": {
			"Type": "AB",
			"Number": "12345"
		}
	}
}

Packages Booking with Service Fee - Response

{
  "TransactionId": "c487acda-5a3c-45df-b2f1-f1de6c104b57",
  "ItineraryNumber": 790110509579,
  "BookingDateTime": "2021-03-16T05:15:37-07:00",
  "PartnerAgentId": "123456",
  "PartnerConfirmationNumber": "hello123",
  "Links": {
    "WebItinRetrieve": {
      "Href": "https://wwwtravelamericanexpresscom.integration.sb.karmalab.net/trips/790110509579?userToken=XQfIGfIBc0Nlel66LEgTfRynxMIyUKe_-_i3ffKRXYpULN8lqfWiYH-e31IbM38BxiGS0HAmqV2deHHDgufva7FhiOgXcx4NoJ2clxQ"
    },
    "ApiItinRetrieve": {
      "Accept": "application/vnd.exp-package.v3+json",
      "Method": "GET",
      "Href": "https://127.0.0.1:8443/packages/bookings/790110509579"
    }
  },
  "Warnings": {
    "FREQUENT_FLYER_PROGRAM_NOT_REQUESTED": "Booking succeeded, but the requested Frequent Flyer Programs are either inapplicable or duplicate - {BA,BA,queen1}"
  },
  "AirlineConfirmations": [
    {
      "MarketingAirlineCode": "HA",
      "ConfirmationNumber": "EXDMWF"
    }
  ],
  "GDSLocators": [
    "EXDLPU"
  ],
  "HotelConfirmation": "8142822879152",
  "NumberOfRooms": 1,
  "Price": {
    "PackageBasePrice": {
      "Value": "671.80",
      "Currency": "USD"
    },
    "PackageTotalPrice": {
      "Value": "737.49",
      "Currency": "USD"
    },
    "PackageTaxesAndFees": {
      "Value": "58.70",
      "Currency": "USD"
    },
    "Fees": [
      {
        "Value": "6.99",
        "Currency": "USD",
        "Name": "Service"
      }
    ],
    "AverageCostPerPerson": {
      "Value": "737.49",
      "Currency": "USD"
    }
  },
  "Hotel": {
    "Id": "7835485",
    "Rooms": [
      {
        "Traveler": {
          "Name": {
            "FirstName": "San",
            "MiddleName": "Edward",
            "LastName": "Zhang"
          },
          "Phone": {
            "CountryCode": "1",
            "AreaCode": "206",
            "Number": "9876543"
          },
          "Email": "v-ryezzu@expedia.com"
        },
        "RoomPreferences": [
          {
            "Type": "SmokingPreference",
            "Value": "NonSmoking"
          },
          {
            "Type": "Bed",
            "Value": "42"
          }
        ],
        "SpecialRequests": "check-in 2 hours late,Crib Required",
        "Occupants": [
          {
            "Adults": 1
          }
        ],
        "StayDates": [
          {
            "CheckInDate": "2021-06-12",
            "CheckOutDate": "2021-06-14"
          }
        ],
        "RatePlans": [
          {
            "RoomTypeId": "200638706",
            "RatePlanId": "203199561",
            "RateRuleId": "205298801",
            "StayDates": {
              "CheckInDate": "2021-06-12",
              "CheckOutDate": "2021-06-14"
            },
            "ConfirmationNumber": "d9e869a9-692c-4a46-ab6e-bc145b40bd0d"
          }
        ],
        "SmokingOption": "NonSmoking"
      }
    ]
  },
  "Flight": {
    "Travelers": [
      {
        "Name": {
          "FirstName": "SAN EDWARD",
          "LastName": "TEST"
        },
        "Gender": "Male",
        "PassengerType": "ADULT",
        "DateOfBirth": "1978-10-23",
        "Tickets": [
          {
            "Refundable": false,
            "RefundPenalty": {
              "PreTripChange": {
                "Allow": "YES",
                "Penalty": {
                  "Value": "0.00",
                  "Currency": "USD"
                }
              },
              "PreTripCancel": {
                "Allow": "NO"
              },
              "EnrouteChange": {
                "Allow": "YES",
                "Penalty": {
                  "Value": "0.00",
                  "Currency": "USD"
                }
              },
              "EnrouteCancel": {
                "Allow": "NO"
              },
              "Transferable": "NO",
              "NameChangeAllowed": "NO"
            }
          }
        ]
      }
    ],
    "Links": {
      "ApiFareRules": {
        "Accept": "application/vnd.exp-flight.v1+json",
        "Method": "GET",
        "Href": "https://apim.int.expedia.com/flights/farerules/CgVjb2FjaBoJUHVibGlzaGVkIgd1bmtub3duKgdwYWNrYWdlMgJIQUJJCAESGTIwMTgtMDYtMTJUMDk6MDA6MDAtMDc6MDAaA0hOTCIDU0VBKgJIQTIGSEhYME9UQgZTRUFITkxKBVNhYnJlagVBRFVMVEJICAISGTIwMTgtMDYtMTRUMTM6MTU6MDAtMTA6MDAaA1NFQSIDSE5MKgJIQTIFTUhYM09CBkhOTFNFQUoFU2FicmVqBUFEVUxU"
      }
    },
    "Free24HourCancellation": true
  }
}

Packages Booking with Service Fee - Response - More Details

{
    	"TransactionId": "c487acda-5a3c-45df-b2f1-f1de6c104b57",
    	"ItineraryNumber": 790110509579,
    	"BookingDateTime": "2021-06-16T05:15:37-07:00",
    	"PartnerAgentId": "123456",
    	"PartnerConfirmationNumber": "hello123",
    	"Links": {
    		"WebItinRetrieve": {
    			"Href": "https://www.expedia.com/trips/790110509579?userToken=XQfIGfIBc0Nlel66LEgTfRynxMIyUKe_-_i3ffKRXYpULN8lqfWiYH-e31IbM38BxiGS0HAmqV2deHHDgufva7FhiOgXcx4NoJ2clxQ"
    		},
    		"ApiItinRetrieve": {
    			"Accept": "application/vnd.exp-package.v3+json",
    			"Method": "GET",
    			"Href": "https://127.0.0.1:8443/packages/bookings/790110509579"
    		}
    	},
    	"Warnings": {
    		"FREQUENT_FLYER_PROGRAM_NOT_REQUESTED": "Booking succeeded, but the requested Frequent Flyer Programs are either inapplicable or duplicate - {BA,BA,queen1}"
    	},
    	"AirlineConfirmations": [{
    		"MarketingAirlineCode": "HA",
    		"ConfirmationNumber": "EXDMWF"
    	}],
    	"GDSLocators": [
    		"EXDLPU"
    	],
    	"HotelConfirmation": "8142822879152",
    	"NumberOfRooms": 1,
    	"Price": {
    		"PackageBasePrice": {
    			"Value": "671.80",
    			"Currency": "USD"
    		},
    		"PackageTotalPrice": {
    			"Value": "737.49",
    			"Currency": "USD"
    		},
    		"PackageTaxesAndFees": {
    			"Value": "58.70",
    			"Currency": "USD"
    		},
    		"Fees": [{
    			"Value": "6.99",
    			"Currency": "USD",
    			"Name": "Service"
    		}],
    		"AverageCostPerPerson": {
    			"Value": "737.49",
    			"Currency": "USD"
    		}
    	},
    	"Hotel": {
    		"Id": "7835485",
    		"Name": "Waikiki Beachside Hostel",
    		"LocalCurrencyCode": "USD",
    		"Location": {
    			"Address": {
    				"Address1": "2556 Lemon Road",
    				"City": "Honolulu",
    				"Province": "HI",
    				"Country": "USA",
    				"PostalCode": "96815"
    			},
    			"GeoLocation": {
    				"Latitude": "21.272664",
    				"Longitude": "-157.821944"
    			}
    		},
    		"Description": {
    			"LocationTeaser": "Located in Waikiki, this hostel is within a 15-minute walk of Honolulu Zoo and Waikiki Aquarium. Diamond Head and University of Hawaii at Manoa are also within 3 mi (5 km). ",
    			"HotelTeaser": "A restaurant, self parking, and concierge services are available at this smoke-free hostel. WiFi in public areas is free. Other amenities include laundry facilities, a 24-hour front desk, and tour/ticket assistance. ",
    			"RoomTeaser": "All 45 rooms offer free WiFi, balconies or patios, and free local calls. "
    		},
    		"ThumbnailUrl": "https://images.trvl-media.com/hotels/8000000/7840000/7835500/7835485/7835485_25_t.jpg",
    		"StarRating": "1.5",
    		"Policies": {
    			"CheckInStartTime": "3:30 PM",
    			"CheckInEndTime": "4 AM",
    			"CheckOutTime": "noon",
    			"PetPolicies": [
    				"Pets not allowed"
    			],
    			"ChildrenAndExtraBedsPolicies": [
    				"Children 18 and younger are not allowed at this adults-only property. All guests older than 18 are welcome.",
    				"Rollaway/extra beds are not available.",
    				"Cribs (infant beds) are not available."
    			]
    		},
    		"HotelAmenities": [{
    				"Id": "4003",
    				"Name": "Luggage storage"
    			},
    			{
    				"Id": "41",
    				"Name": "ATM/banking"
    			},
    			{
    				"Id": "43",
    				"Name": "Concierge services"
    			},
    			{
    				"Id": "2063",
    				"Name": "24-hour front desk"
    			},
    			{
    				"Id": "2001",
    				"Name": "Free breakfast"
    			},
    			{
    				"Id": "369",
    				"Name": "Laundry facilities"
    			},
    			{
    				"Id": "2387",
    				"Name": "Tours/ticket assistance"
    			},
    			{
    				"Id": "52",
    				"Name": "Total number of rooms - 45"
    			},
    			{
    				"Id": "2004",
    				"Name": "Coffee shop or café"
    			},
    			{
    				"Id": "372",
    				"Name": "Television in common areas"
    			},
    			{
    				"Id": "54",
    				"Name": "Number of floors - 3"
    			},
    			{
    				"Id": "2390",
    				"Name": "Free WiFi"
    			},
    			{
    				"Id": "55",
    				"Name": "Number of buildings/towers - 3"
    			},
    			{
    				"Id": "2137",
    				"Name": "Smoke-free property"
    			}
    		],
    		"Rooms": [{
    			"Traveler": {
    				"Name": {
    					"FirstName": "John",
    					"MiddleName": "Edward",
    					"LastName": "Doe"
    				},
    				"Phone": {
    					"CountryCode": "1",
    					"AreaCode": "206",
    					"Number": "9876543"
    				},
    				"Email": "v-ryezzu@expedia.com"
    			},
    			"RoomPreferences": [{
    					"Type": "SmokingPreference",
    					"Value": "NonSmoking"
    				},
    				{
    					"Type": "Bed",
    					"Value": "42"
    				}
    			],
    			"SpecialRequests": "check-in 2 hours late,Crib Required",
    			"Occupants": [{
    				"Adults": 1
    			}],
    			"StayDates": [{
    				"CheckInDate": "2021-06-12",
    				"CheckOutDate": "2021-06-14"
    			}],
    			"Description": "Shared Dormitory, 1 Twin Bed (8 Person Dorm)",
    			"RatePlans": [{
    				"RoomTypeId": "200638706",
    				"RatePlanId": "203199561",
    				"RateRuleId": "205298801",
    				"InventorySourceId": "24",
    				"StayDates": {
    					"CheckInDate": "2021-06-12",
    					"CheckOutDate": "2021-06-14"
    				},
    				"PaymentMethod": "Online",
    				"CancellationPolicy": {
                      "Refundable": true,
                      "FreeCancellation": true,
                      "FreeCancellationEndDateTime": "2021-09-25T18:00:00-10:00",
                      "CancellationPenaltyRules": [
                        {
                          "PenaltyNightCount": 2,
                          "PenaltyStartDateTime": "2021-09-25T18:00:00-10:00",
                          "PenaltyEndDateTime": "2021-09-29T18:00:00-10:00"
                        }
                      ],
                      "CancelPolicyDescription": "Cancellations or changes made after 18:00 (hotel local time) on September 25, 2021 or no-shows are subject to a property fee equal to the first and second nights rates plus taxes and fees."
                    },
    				"ConfirmationNumber": "d9e869a9-692c-4a46-ab6e-bc145b40bd0d"
    			}],
    			"SmokingOption": "NonSmoking",
    			"Amenities": [{
    					"Id": "4226",
    					"Name": "Phone"
    				},
    				{
    					"Id": "4120",
    					"Name": "Air conditioning"
    				},
    				{
    					"Id": "4216",
    					"Name": "Microwave"
    				},
    				{
    					"Id": "4233",
    					"Name": "Private bathroom"
    				},
    				{
    					"Id": "4315",
    					"Name": "Shower only"
    				},
    				{
    					"Id": "4347",
    					"Name": "Free WiFi"
    				},
    				{
    					"Id": "4092",
    					"Name": "Square meters -45"
    				},
    				{
    					"Id": "4093",
    					"Name": "Square feet -500"
    				}
    			]
    		}]
    	},
    	"Flight": {
    		"International": false,
    		"Travelers": [{
    			"Name": {
    				"FirstName": "JOHN EDWARD",
    				"LastName": "TEST"
    			},
    			"Primary": true,
    			"Gender": "Male",
    			"PassengerType": "ADULT",
    			"DateOfBirth": "1978-10-23",
    			"TsaNumber": "1.1",
    			"Tickets": [
                  {
                    "TicketingAirlineCode": "UA",
                    "Refundable": false,
                    "RefundPenalty": {
                      "PreTripChange": {
                        "Allow": "YES",
                        "Penalty": {
                          "Value": "0.00",
                          "Currency": "USD"
                        }
                      },
                      "PreTripCancel": {
                        "Allow": "NO"
                      },
                      "EnrouteChange": {
                        "Allow": "YES",
                        "Penalty": {
                          "Value": "0.00",
                          "Currency": "USD"
                        }
                      },
                      "EnrouteCancel": {
                        "Allow": "NO"
                      },
                      "Transferable": "NO",
                      "NameChangeAllowed": "NO"
                    }
                  }
                ]
    		}],
    		"Segments": [{
    		        "SegmentId": "MzkwNDkwNzUzNDA0NTgxODg4MTE=",
    				"FlightDuration": "PT6H5M",
    				"TotalStops": 0,
    				"DepartureArrivalDayDifference": 0,
    				"AirportChange": false,
    				"FareType": "PUBLISHED",
    				"Links": {
    					"ApiBaggageFees": {
    						"Accept": "application/vnd.exp-flight.v1+json",
    						"Method": "GET",
    						"Href": "http://apim.expedia.com/flights/baggagefees/CkIKAkhBEgJIQRoKMjAxOC0wNi0xMiIDU0VBKgoyMDE4LTA2LTEyMgNITkw6AUhCBkhIWDBPVEoHRUNPTk9NWVICMjESA1VTRBoCa2c"
    					}
    				},
    				"Legs": [{
    				    "StatusCode": "HK",
    					"DepartureAirport": {
    						"Code": "SEA",
    						"Name": "Seattle - Tacoma Intl.",
    						"City": "Seattle",
    						"Province": "Washington",
    						"Country": "USA",
    						"Latitude": "47.44363",
    						"Longitude": "-122.30175"
    					},
    					"ArrivalAirport": {
    						"Code": "HNL",
    						"Name": "Daniel K. Inouye Intl.",
    						"City": "Honolulu",
    						"Province": "Hawaii",
    						"Country": "USA",
    						"Latitude": "21.332544",
    						"Longitude": "-157.919701"
    					},
    					"DepartureDateTime": "2021-06-12T09:00:00-07:00",
    					"ArrivalDateTime": "2021-06-12T12:05:00-10:00",
    					"FlightNumber": "21",
    					"MarketingAirlineCode": "HA",
    					"MarketingAirlineName": "Hawaiian Airlines",
    					"OperatingAirlineCode": "HA",
    					"OperatingAirlineName": "Hawaiian Airlines",
    					"EquipmentCode": "332",
    					"EquipmentName": "Airbus A330-200",
    					"FlightDuration": "PT6H5M",
    					"FareBasisCode": "T21DVN5",
    					"FlightDistance": {
    						"Value": "2676",
    						"Unit": "miles"
    					},
    					"BookingCode": "H",
    					"CabinClass": "ECONOMY",
    					"EquipmentChange": false,
    					"LoungeKeys": [
    						"SEACENTURION"
    					],
    					"AirlineConfirmation": {
    						"MarketingAirlineCode": "HA",
    						"ConfirmationNumber": "EXDMWF"
    					},
    					"GDSLocator": "EXDLPU"
    				}]
    			},
    			{
    				"FlightDuration": "PT5H45M",
    				"TotalStops": 0,
    				"DepartureArrivalDayDifference": 0,
    				"AirportChange": false,
    				"FareType": "PUBLISHED",
    				"Links": {
    					"ApiBaggageFees": {
    						"Accept": "application/vnd.exp-flight.v1+json",
    						"Method": "GET",
    						"Href": "http://apim.expedia.com/flights/baggagefees/CkEKAkhBEgJIQRoKMjAxOC0wNi0xNCIDSE5MKgoyMDE4LTA2LTE0MgNTRUE6AU1CBU1IWDNPSgdFQ09OT01ZUgIyMhIDVVNEGgJrZw"
    					}
    				},
    				"Legs": [{
    					"DepartureAirport": {
    						"Code": "HNL",
    						"Name": "Daniel K. Inouye Intl.",
    						"City": "Honolulu",
    						"Province": "Hawaii",
    						"Country": "USA",
    						"Latitude": "21.332544",
    						"Longitude": "-157.919701"
    					},
    					"ArrivalAirport": {
    						"Code": "SEA",
    						"Name": "Seattle - Tacoma Intl.",
    						"City": "Seattle",
    						"Province": "Washington",
    						"Country": "USA",
    						"Latitude": "47.44363",
    						"Longitude": "-122.30175"
    					},
    					"DepartureDateTime": "2021-06-14T13:15:00-10:00",
    					"ArrivalDateTime": "2021-06-14T22:00:00-07:00",
    					"FlightNumber": "22",
    					"MarketingAirlineCode": "HA",
    					"MarketingAirlineName": "Hawaiian Airlines",
    					"OperatingAirlineCode": "HA",
    					"OperatingAirlineName": "Hawaiian Airlines",
    					"EquipmentCode": "332",
    					"EquipmentName": "Airbus A330-200",
    					"FlightDuration": "PT5H45M",
    					"FareBasisCode": "T21DVN5",
    					"FlightDistance": {
    						"Value": "2676",
    						"Unit": "miles"
    					},
    					"BookingCode": "M",
    					"CabinClass": "ECONOMY",
    					"EquipmentChange": false,
    					"AirlineConfirmation": {
    						"MarketingAirlineCode": "HA",
    						"ConfirmationNumber": "EXDMWF"
    					},
    					"GDSLocator": "EXDLPU"
    				}]
    			}
    		],
    		"Links": {
    			"ApiFareRules": {
    				"Accept": "application/vnd.exp-flight.v1+json",
    				"Method": "GET",
    				"Href": "http://apim.expedia.com/flights/farerules/CgVjb2FjaBoJUHVibGlzaGVkIgd1bmtub3duKgdwYWNrYWdlMgJIQUJJCAESGTIwMTgtMDYtMTJUMDk6MDA6MDAtMDc6MDAaA0hOTCIDU0VBKgJIQTIGSEhYME9UQgZTRUFITkxKBVNhYnJlagVBRFVMVEJICAISGTIwMTgtMDYtMTRUMTM6MTU6MDAtMTA6MDAaA1NFQSIDSE5MKgJIQTIFTUhYM09CBkhOTFNFQUoFU2FicmVqBUFEVUxU"
    			}
    		},
    		"Free24HourCancellation": true,
    		"Lounges": {
    			"SEACENTURION": [{
    				"Name": "The Centurion Lounge",
    				"IsConferenceRoomAvailable": false,
    				"PhoneNumber": "N/A",
    				"Description": "Concourse B, opposite Gate B3"
    			}]
    		}
    	}
    }


Error Codes

Common Error Codes

CodeMessageDescription
FAILED_TO_RESERVE_SEATBooking succeeded but failed to reserve the requested seats due to invalid flight information.This warning is returned in case a customer sends a seat request with the invalid flight info, i.e. the flight number, departure date, arrival date, departure airport, and/or arrival airport do not match any AirLeg of the corresponding ANK product in the booking request. In this case, we will ignore that particular seat request and return a warning.
FREQUENT_FLYER_PROGRAM_NOT_REQUESTEDBooking succeeded but the requested Frequent Flyer Programs are either inapplicable or duplicate -{AS,AS,6451734} {DL,DL,645171}A frequent flyer request will be requested only if the MarketingCarrierCode matches at least one of the operating airlines. Other entries will be ignored. In case the traveler enters more than one frequent flyer program entries for the same MarketingCarrierCode, only one will be requested and the rest will be ignored. The warning message will contain the list of programs ignored in the format {MarketingCarrierCode,ProgramCarrierCode,Number}
MULTIPLE_SPECIAL_ASSISTANCE_NOT_SUPPORTEDBooking succeeded but only one special assistance is currently supported, so only the first one has been requested.This warning is returned if the customer requests multiple special assistance in the booking request. Currently only one special assistance is supported per booking request.
BOOKED_WITH_PRICE_INCREASEBooking succeeded but with a slightly higher price.Booking was successful but the booked price was incrementally higher than the quoted price.The difference in price is within the price increase limit custom configured for this partner. If it was not the booking would fail due to the price increase.
BOOKED_WITH_PRICE_DECREASEBooking succeeded but with a slightly lower price.Booking was successful, but the booked price was incrementally lower than the quoted price.The difference in price is within the price decrease limit custom configured for this partner. If it was not the booking would fail due to the price decrease.

Fault Error Codes

HTTP Status CodeError codeError Message
400INVALID_REQUESTRequest is either missing or is in an invalid format.
400PACKAGE_FLIGHT_MISSINGPackage flight information is missing.
400PACKAGE_HOTEL_MISSINGPackage hotel information is missing.
409INVALID_OFFER_IDOfferId provided is either invalid or expired.
400INVALID_EMAILBooking Failed. Email address in the request is either missing or invalid.
400INVALID_TRIP_TITLEBooking Failed. Trip title is too long.
400INVALID_PRICETotal price is either missing or invalid.
400INVALID_CURRENCYCurrency is either missing or invalid.
400INVALID_CLIENT_KEYInvalid client key: xxx
400INVALID_BILLING_ADDRESSBooking Failed. Billing address is either missing or invalid. Please provide the following required fields: Address1, City, Country.
400INVALID_BILLING_DETAILSBilling information is either missing or invalid.
400INVALID_CREDIT_CARDBooking Failed. Credit card information in the request is either missing or invalid.
400INVALID_CREDIT_CARD_TYPEBooking Failed. The credit card type is invalid.
400INVALID_CREDIT_CARD_NUMBERBooking Failed. The credit card number is invalid.
400INVALID_DIRECT_DEBITBooking Failed. Direct debit information in the request is either missing or invalid.
400INVALID_BILLING_NAMEBilling name is either missing or invalid.
400INVALID_TRAVELER_INFOBooking Failed. Traveler information in the request is either missing or invalid.
400INVALID_TRAVELER_NAMEBooking Failed. Traveler name in the request is either missing or invalid.
400TRAVELER_NAMES_NOT_UNIQUETraveler names must be unique.
400INVALID_TRAVELER_PHONEBooking Failed. Traveler phone information in the request is either missing or invalid.
400INVALID_TRAVELER_COUNTBooking Failed. Exactly one primary traveler should be present in request body.
400INVALID_TRAVELER_COUNTBooking Failed. Traveler count information in the request is either missing or invalid.
400INVALID_TRAVELERSBooking Failed. Travelers information in the request is missing or is in an invalid format.
400CHILD_OR_INFANT_PRIMARY_TRAVELERBooking failed. Child/infant traveler cannot be a primary traveler.
500BOOKING_APPLICATION_ERRORBooking failed. Application Error.
500BOOKING_NOT_CONFIRMEDProblem confirming your booking. Please call Expedia customer support.
409PRICE_INCREASEBooking Failed. The price for your trip has changed from %s %s to %s %s.
409PRICE_DECREASEBooking Failed. The price for your trip has changed from %s %s to %s %s.
400CURRENCY_NOT_SUPPORTEDBooking Failed. Currency not accepted at this hotel.
400PAYMENT_BILLING_ADDRESS_NOT_MATCHBooking Failed. The billing address and ZIP/ Postal code does not match.
400PAYMENT_TRANSACTION_FAILEDBooking failed. Transaction failed via credit card clearing house.
400PAYMENT_CREDIT_CARD_COULD_NOT_BE_VALIDATEDBooking failed. Could not validate credit card. Try again later or use another card.
400INVALID_DATE_OF_BIRTHBooking Failed. Date of birth is a required field, it cannot be null, empty or invalid.
400INVALID_DATE_OF_BIRTHBooking Failed. Date of birth in the request cannot be in the future.
400UNKNOWN_PATHUnknown request path
400INVALID_FRAUD_CHECK_IDFraudCheckId is either missing or invalid.
400INVALID_ACCEPT_HEADERAPI version is either missing or invalid. Please provide a correct API version in the Accept header.
400ORDER_DECLINEDBooking failed. Order creation has been declined.
400INVALID_USER_IDUser-Id in http headers is missing or invalid. It has to be a valid email.
400PARTNER_TRANSACTION_ID_MISSINGPartner transaction Id in http headers is missing.
400UNKNOWN_FIELDUnrecognized field "<unknown field>"
400CREDIT_CARD_NOT_SUPPORTEDCredit card type is not supported for the channel.
400CREDIT_CARD_NOT_SUPPORTEDBooking Failed. The credit card is not accepted by this hotel, please use another one.
400DIRECT_DEBIT_NOT_SUPPORTEDDirect debit is not supported for the channel.
400CREDIT_CARD_EXPIREDBooking Failed. The credit card has expired.
400INVALID_SOURCESource field is invalid. Allowed values: [browser/ mobileapp/ mobilesite].
400INVALID_DATESBooking Failed. Dates in the request are missing or in invalid format. Valid format is " YYYY-MM-DD."
400INVALID_PAYMENT_TOKENPayment token information is invalid.

Flight-Specific Fault Error Codes

HTTP Status CodeError codeError Message
409FLIGHT_NOT_AVAILABLEBooking Failed. The flight requested for is no longer available.
409FLIGHT_SCHEDULE_CHANGEBooking Failed. The requested flight had a change of schedule.
409FLIGHT_SEATS_UNAVAILABLEBooking Failed. No seats available for the chosen cabin class.
400INVALID_FREQUENT_FLYER_PROGRAMBooking Failed. MarketingCarrierCode for one of the Frequent Flyer Programs requested is missing or invalid.
400INVALID_FREQUENT_FLYER_PROGRAMBooking Failed. ProgramCarrierCode for one of the Frequent Flyer Programs requested is missing or invalid.
400INVALID_FREQUENT_FLYER_PROGRAMBooking Failed. Number for one of the Frequent Flyer Programs requested is missing or invalid.
400INVALID_REDRESS_NUMBERBooking Failed. RedressNumber in not in size range(min=1, max=15).
400INVALID_EMERGENCY_CONTACTBooking Failed. Emergency contact information in the request is either missing or invalid.
400INVALID_EMERGENCY_CONTACT_PHONEBooking Failed. Emergency contact phone information in the request is either missing or invalid.
400INVALID_EMERGENCY_CONTACT_NAMEBooking Failed. Emergency contact name in the request is either missing or invalid.
400INVALID_PASSENGER_TYPEPassengerType is a required field. Allowed values: [ADULT/ SENIOR/ CHILD/ INFANT_IN_SEAT/ INFANT_IN_LAP].
400INVALID_SEAT_INFOBooking Failed. Departure date in seat info cannot be null or empty.
400INVALID_SEAT_INFOBooking Failed. Seat number in seat info cannot be null or empty
400INVALID_SEAT_INFOBooking Failed. Flight number in seat info cannot be null or empty.
400INVALID_SEAT_INFOBooking Failed. Arrival airport code in seat info cannot be null or empty.
400INVALID_SEAT_INFOBooking Failed. Departure airport code in seat info cannot be null or empty.
400INVALID_GENDERBooking Failed. Gender is a required field, It has to be [Male/ Female/ Unknown].
400INVALID_PASSPORT_NUMBERBooking Failed. Passport number field in the request is missing or invalid.
400INVALID_PASSPORT_COUNTRYBooking Failed. Passport country code field in the request is missing or invalid.
400INVALID_SEAT_PREFERENCEBooking Failed. Seat preference is invalid, It has to be [Window/ Aisle].
INVALID_SPECAIL_ASSISTANCESBooking Failed. SpecialAssistances is invalid.It is an array type.Elements have to be [NONE/ BLIND_WITH_SEEING_EYE_DOG/ DEAF_WITH_HEARING_DOG/ WHEELCHAIR_CAN_CLIMB_STAIRS/ WHEELCHAIR_CANNOT_CLIMB_STAIRS/ WHEELCHAIR_IMMOBILE/ BLINDWITHSEEINGEYEDOG/ DEAFWITHHEARINGDOG/ WHEELCHAIRCANCLIMBSTAIRS/ WHEELCHAIRCANNOTCLIMBSTAIRS/ WHEELCHAIRIMMOBILE].400

Hotel-Specific Fault Error Codes

HTTP Status CodeError codeError Message
400INVALID_ROOM_DETAILSRoom details info is either missing or invalid.
400INVALID_ROOM_PREFERENCES_TYPERoomPreferences type is invalid. Allowed values: SmokingPreference or Bed.
400INVALID_SMOKING_PREFERENCE_VALUESmoking preference is invalid. Allowed values: SmokingOrNonSmoking, Smoking or NonSmoking.
400INVALID_BED_PREFERENCE_VALUEBed preference is invalid.Bed value should be a number.
400SMOKING_PREFERENCE_NOT_SUPPORTEDBooking Failed. The requested smoking option is not supported by this hotel product.
400INVALID_HOTEL_CHILD_AGEBooking Failed. The child age is invalid.
500HOTEL_ROOM_RATE_PLAN_NOT_AVAILABLEBooking Failed. The hotel room rate plan requested for is no longer available.
500HOTEL_ROOM_TYPE_NOT_FOUNDBooking Failed. Hotel room type is not found for this hotel. Please select a different room, dates or a hotel.
500HOTEL_RULES_CHANGEDBooking Failed. The hotel rules have been changed.
500HOTEL_ROOM_RULES_CHANGEDBooking Failed. The requested stay is not permitted by the current hotel rules.
500HOTEL_NO_AVAILABLE_ROOMSBooking failed. No rooms are available in this hotel.
500INVALID_STAY_DATESBooking Failed. Room not available for the selected dates.
500INVALID_NUMBER_OF_ROOMSBooking Failed. Room count exceeds available rooms.
500HOTEL_NOT_AVAILABLEBooking Failed. The hotel requested is not available.
400DEPOSIT_NOT_ACCEPTEDBooking Failed. Credit card deposit is not accepted by this hotel.
400INVALID_EXPIRATION_DATEBooking Failed. The expiration date on the credit card is either invalid or expires prior to check out.
400PAYMENT_TRANSACTION_FAILEDBooking failed. Transaction failed via credit card clearing house.
500HOTEL_RESERVATION_CAN_NOT_BE_CONFIRMEDBooking Failed. Hotel reservation cannot be confirmed. Please try again later.
500HOTEL_CANNOT_BE_BOOKEDBooking Failed. This hotel cannot be booked through Expedia at present.
400INVALID_HOTEL_REQUESTED_NIGHTSBooking Failed. The number of requested nights is invalid.
400MIN_LENGTH_OF_STAY_REQUIREDBooking Failed. Because there is a minimum length of stay restriction for this hotel.
400HOTEL_ROOM_RATE_PLAN_NO_LONGER_AVAILABLEBooking Failed. The hotel room rate plan requested for is no longer available.
400HOTEL_STATUS_CHANGEDBooking Failed. The status of the hotel has changed.
400HOTEL_STATIC_RULES_NOT_FOUNDBooking Failed. Hotel static rules are not found.
400HOTEL_PRICE_CHANGEDBooking Failed. The hotel price has changed during booking.
400HOTEL_CURRENCY_CHANGEDBooking Failed. The hotel currency has changed.
400HOTEL_LODGING_NOT_AVAILABLEBooking Failed. The lodging is not available for your selected dates.
400INVALID_HOTEL_CHECKIN_DATEBooking failed. The hotel checkin date is invalid.
400INVALID_HOTEL_LOYALTY_INFOBooking Failed. Hotel loyalty type and Hotel loyalty number are both required.
400CHILD_AGE_OVER_TWELVEChild 12 years or older during travel is priced as Adult. Please update your search criteria.

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!