Lodging Resume Booking API
Guidance and examples for accessing the Lodging Resume Booking API
The Lodging Resume Booking API allows you to resume a lodging booking that is currently in a pending booking status while awaiting payment.
Endpoint
| Method | Endpoint | Prerequisites |
|---|---|---|
| PUT | https://apim.expedia.com/hotels/bookings/[TripNumber]/resume/ | An active TripNumber from the Lodging Booking API. |
Required Headers
| Key: | Expedia API key |
| Authorization: | Expedia API Authorization String |
| User-Id: | username@domain.com The is 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-hotel.v3+json |
| Partner-Transaction-Id: | [Partner TransactionID String] |
Next Steps
- View itinerary via Lodging Retrieve API.
- View cancellation details via Lodging PreCancel API.
- Cancel a booking via Lodging Cancel API.
- Go to weblink for retrieve.
Hotel Resume Booking Request and Response Examples
Booking URL and Headers
https://apim.expedia.com/hotels/bookings/[tripNumber]/resume?releaseHoldIfPossible=falseConfirmation Response When Called On Pending Trip After Making Payment
{
"TransactionId": "263990aa-85ad-47aa-9f0c-10faf3e731dc",
"OrderNumber": "9030261720045",
"HotelConfirmation": "8084147561681",
"ItineraryNumber": 7163534679,
"NumberOfRooms": 1,
"LengthOfStay": 6,
"PartnerConfirmationNumber": "hello123",
"PartnerAgentId": "123456",
"BookingDate": "2022-09-10T22:07:00-07:00",
"HotelDetails": {
"Id": "5027392",
"Name": "Hampton Inn & Suites Seattle-Airport/28th Ave",
"LocalCurrencyCode": "USD",
"Location": {
"Address": {
"Address1": "18850 28th Ave South",
"City": "Seatac",
"Province": "WA",
"Country": "USA",
"PostalCode": "98188"
},
"GeoLocation": {
"Latitude": "47.432792",
"Longitude": "-122.29812"
}
},
"Description": {
"LocationTeaser": "Situated near the airport, this hotel is within a 15-minute walk of Silver Dollar Casino and Angle Lake Park. Wizards Casino and Highline Community College are also within 6 mi (10 km). ",
"HotelTeaser": "An indoor pool, a 24-hour fitness center, and a 24-hour business center are available at this smoke-free hotel. Free buffet breakfast is provided, as well as free WiFi in public areas, a free airport shuttle, and a free shopping center shuttle. Other amenities include a conference center, coffee/tea in a common area, and conference rooms. ",
"RoomTeaser": "All 218 rooms offer free WiFi and free wired Internet, LCD TVs with cable channels, and comforts like pillow menus and down comforters. Guests will also find MP3 docks, hydromassage showerheads, and coffee makers. "
},
"ThumbnailUrl": "https://images.trvl-media.com/hotels/5000000/4700000/4694100/4694093/3a0c141c_t.jpg",
"Media": [{
"Type": "1",
"Title": "Featured Image",
"Size": "b",
"Url": "https://images.trvl-media.com/hotels/5000000/4700000/4694100/4694093/3a0c141c_b.jpg"
},
{
"Type": "1",
"Title": "Featured Image",
"Size": "s",
"Url": "https://images.trvl-media.com/hotels/5000000/4700000/4694100/4694093/3a0c141c_s.jpg"
},
{
"Type": "1",
"Title": "Featured Image",
"Size": "t",
"Url": "https://images.trvl-media.com/hotels/5000000/4700000/4694100/4694093/3a0c141c_t.jpg"
},
{
"Type": "1",
"Title": "Featured Image",
"Size": "y",
"Url": "https://images.trvl-media.com/hotels/5000000/4700000/4694100/4694093/3a0c141c_y.jpg"
},
{
"Type": "1",
"Title": "Featured Image",
"Size": "z",
"Url": "https://images.trvl-media.com/hotels/5000000/4700000/4694100/4694093/3a0c141c_z.jpg"
}
],
"StarRating": "2.5",
"Policies": {
"CheckInStartTime": "3 PM",
"CheckInEndTime": "midnight",
"CheckOutTime": "noon",
"PetPolicies": [
"Pets not allowed"
],
"ChildrenAndExtraBedsPolicies": [
"Children are welcome.",
"Kids stay free! Up to 2 children 17 years old and younger stay free when using existing bedding.",
"Rollaway/extra beds are not available.",
"Cribs (infant beds) are not available."
]
},
"HotelAmenities": [
{
"Id": "8",
"Name": "Elevator/lift"
},
{
"Id": "10",
"Name": "Free airport transportation"
},
{
"Id": "52",
"Name": "Total number of rooms - 218"
},
{
"Id": "54",
"Name": "Number of floors - 5"
},
{
"Id": "55",
"Name": "Number of buildings/towers - 1"
},
{
"Id": "2177",
"Name": "Express check-in"
},
{
"Id": "2131",
"Name": "Meeting rooms2"
},
{
"Id": "2137",
"Name": "Smoke-free property"
},
{
"Id": "2067",
"Name": "Express check-out"
},
{
"Id": "2070",
"Name": "Dry cleaning/laundry service"
},
{
"Id": "2072",
"Name": "Limo or Town Car service available"
},
{
"Id": "2043",
"Name": "Multilingual staff"
},
{
"Id": "2047",
"Name": "Free newspapers in lobby"
},
{
"Id": "317",
"Name": "Fireplace in lobby"
},
{
"Id": "324",
"Name": "Coffee/tea in common areas"
},
{
"Id": "369",
"Name": "Laundry facilities"
},
{
"Id": "2001",
"Name": "Free breakfast"
},
{
"Id": "2016",
"Name": "Safe-deposit box at front desk"
},
{
"Id": "4451",
"Name": "Long-term parking (surcharge)"
},
{
"Id": "4455",
"Name": "Offsite parking discounted rates available"
},
{
"Id": "4456",
"Name": "Offsite parking reservations required"
},
{
"Id": "2390",
"Name": "Free WiFi"
},
{
"Id": "2392",
"Name": "Free wired high-speed Internet"
},
{
"Id": "2945",
"Name": "Cruise terminal shuttle (surcharge)"
},
{
"Id": "3865",
"Name": "Computer station"
},
{
"Id": "4003",
"Name": "Luggage storage"
},
{
"Id": "2515",
"Name": "Year Built2012"
},
{
"Id": "2528",
"Name": "Free area shuttle"
},
{
"Id": "2538",
"Name": "24-hour business center"
},
{
"Id": "2539",
"Name": "Conference space size (feet) - 1932"
},
{
"Id": "2593",
"Name": "Number of meeting rooms - 2"
},
{
"Id": "3372",
"Name": "Conference center"
},
{
"Id": "2063",
"Name": "24-hour front desk"
},
{
"Id": "81",
"Name": "Conference space"
},
{
"Id": "4468",
"Name": "24-hour fitness facilities"
},
{
"Id": "2948",
"Name": "Free shopping center shuttle"
},
{
"Id": "3761",
"Name": "Parking (limited spaces)"
},
{
"Id": "3862",
"Name": "Self parking (surcharge)"
},
{
"Id": "2592",
"Name": "Conference space size (meters) - 179"
},
{
"Id": "14",
"Name": "Indoor pool"
}
],
"Accessibility": [
"Accessible bathroom",
"Roll-in shower",
"Accessible parking",
"In-room accessibility"
],
"Rooms": [
{
"Traveler": {
"Name": {
"FirstName": "Naznin",
"LastName": "Fauzia"
},
"Phone": {
"CountryCode": "1",
"AreaCode": "206",
"Number": "9876543"
},
"Email": "nfauzia@expedia.com"
},
"RoomPreferences": [
{
"Type": "SmokingPreference",
"Value": "NonSmoking"
},
{
"Type": "Bed",
"Value": "23"
}
],
"Occupants": [
{
"Adults": 1
}
],
"StayDates": [
{
"CheckInDate": "2022-09-20",
"CheckOutDate": "2022-09-22"
}
],
"Description": "Room, 2 Queen Beds, Accessible",
"RatePlanType": "standalone",
"RatePlans": [
{
"RoomTypeId": "201134299",
"RatePlanId": "205372621",
"RateRuleId": "210248751",
"InventorySourceId": "24",
"StayDates": {
"CheckInDate": "2022-09-20",
"CheckOutDate": "2022-09-22"
},
"Price": {
"BaseRate": {
"Value": "366.16",
"Currency": "USD"
},
"TaxesAndFees": {
"Value": "49.40",
"Currency": "USD"
},
"TotalPrice": {
"Value": "415.56",
"Currency": "USD"
},
"AvgNightlyRate": {
"Value": "183.08",
"Currency": "USD"
},
"RoomRates": [
{
"RoomIndex": 1,
"NightlyRates": [
{
"StayDate": "2022-09-20",
"BaseRate": {
"Value": "183.08",
"Currency": "USD"
},
"TaxesAndFees": {
"Value": "24.70",
"Currency": "USD"
},
"TotalPrice": {
"Value": "207.78",
"Currency": "USD"
}
},
{
"StayDate": "2022-09-21",
"BaseRate": {
"Value": "183.08",
"Currency": "USD"
},
"TaxesAndFees": {
"Value": "24.70",
"Currency": "USD"
},
"TotalPrice": {
"Value": "207.78",
"Currency": "USD"
}
}
]
}
]
},
"PaymentMethod": "Online",
"CancellationPolicy": {
"Refundable": false,
"FreeCancellation": false,
"CancellationPenaltyRules": [
{
"PenaltyPercentOfStay": "100",
"PenaltyStartDateTime": "2022-09-10T22:07:00-07:00",
"PenaltyEndDateTime": "2022-09-22T16:00:00-07:00"
}
]
},
"Amenities": [
{
"Id": "2191",
"Name": "Free High-Speed Internet"
},
{
"Id": "2205",
"Name": "Breakfast Buffet"
}
],
"ConfirmationNumber": "a74e2f9a-b1bd-40ea-90ce-651c0ffb20b8",
"Links": {
"ApiCancel": {
"Accept": "application/vnd.exp-hotel.v3+json",
"Method": "PUT",
"Href": "https://apim.expedia.com/hotels/bookings/7163534679?roomConfirmations=a74e2f9a-b1bd-40ea-90ce-651c0ffb20b8"
}
}
}
],
"Price": {
"BaseRate": {
"Value": "366.16",
"Currency": "USD"
},
"TaxesAndFees": {
"Value": "49.40",
"Currency": "USD"
},
"TotalPrice": {
"Value": "415.56",
"Currency": "USD"
},
"AvgNightlyRate": {
"Value": "183.08",
"Currency": "USD"
}
},
"Links": {
"ApiCancel": {
"Accept": "application/vnd.exp-hotel.v3+json",
"Method": "PUT",
"Href": "https://apim.expedia.com/hotels/bookings/7163534679?roomConfirmations=a74e2f9a-b1bd-40ea-90ce-651c0ffb20b8"
}
},
"SmokingOption": "NonSmoking",
"Amenities": [
{
"Id": "4137",
"Name": "Coffee/tea maker"
},
{
"Id": "4140",
"Name": "Free toiletries"
},
{
"Id": "4152",
"Name": "Designer toiletries"
},
{
"Id": "4153",
"Name": "Desk"
},
{
"Id": "4208",
"Name": "Iron/ironing board"
},
{
"Id": "4213",
"Name": "LCD TV"
},
{
"Id": "4946",
"Name": "Hydromassage showerhead"
}
]
}
]
},
"TotalPrice": {
"Value": "415.56",
"Currency": "USD"
},
"Links": {
"ApiCancel": {
"Accept": "application/vnd.exp-hotel.v3+json",
"Method": "PUT",
"Href": "https://apim.expedia.com/hotels/bookings/7163534679"
},
"ApiPreCancel": {
"Accept": "application/vnd.exp-hotel.v3+json",
"Method": "GET",
"Href": "https://apim.expedia.com/hotels/bookings/7163534679/canceldetails"
},
"WebItinRetrieve": {
"Href": "https://wwwexpediacom.int-milan.sb.karmalab.net/trips/7163534679?userToken="
},
"ApiItinRetrieve": {
"Accept": "application/vnd.exp-hotel.v3+json",
"Method": "GET",
"Href": "https://apim.expedia.com/hotels/bookings/7163534679"
}
}
}Resume Response When Called On Pending Trip To Release Hold On Order
{
"TransactionId": "56cac4ff-ed3e-4ad1-8cda-30effa42bf3d",
"ReleaseHold": "SUCCESS",
"Description": "Order was released as a result of client's request."
}Payment Pending Error Response
{
"Errors": [{
"Code": "PAYMENT_PENDING",
"Description": "Resume booking called before making redirection payment.",
"Links": {
"ApiResume": {
"Accept": "application/vnd.exp-hotel.v3+json",
"Method": "PUT",
"Href": "https://apim.expedia.com/hotels/bookings/7163798117/resume"
},
"PayPalCompletion": {
"Href": "https://www.expedia.com/redirect-proxy/out/9JQKTgTZRP7h37PyxNwAz6t3QlgzzLw9r013PYkpnqrBTLoJ"
}
}
}],
"TransactionId": "0c280398-32bb-4e14-abb4-265bf27adad1"
}Resume Call On Expired Or Reversed Trip Number
{
"Errors": [{
"Code": "PAYPAL_EXPIRED_TRIP",
"Description": "PayPal payment was not completed on time or trip has been reversed. Trip no longer exists."
}],
"TransactionId": "3b1d6a6d-b9ef-42c8-adb7-3733c490291f"
}Resume Call On A Processed Or Booked Trip Number
{
"Errors": [{
"Code": "RESUME_CALL_INVALID",
"Description": "Trip has already been processed. Call Retrieve booking for additional details."
}],
"TransactionId": "0f5c105a-8358-49d3-9f5e-36849ad1d700"
}Error Codes
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.