Amend booking checkin, checkout or occupancies

Overview

Hard Amendment — Search for alternative rates at the same hotel and create up to 3 ready-to-book prebook sessions for a confirmed booking. Used when the guest needs to change their check-in/check-out dates or room occupancy.

When to Use

• Date changes — Guest needs different check-in or check-out dates
• Occupancy changes — Guest needs a different number of adults or children
• Hard amendments — Situations where the booking must be cancelled and re-booked with new parameters

How It Works

1. The system searches for live availability at the same hotel with the new parameters.
2. Up to 3 alternative rates are selected (sorted by price ascending).
3. A prebook session is created for each rate.
4. The caller receives a list of prebookId values ready to be used with POST /rates/book.

What You Get

• Up to 3 prebook sessions — Each with a prebookId, final pricing, cancellation policies, and room details
• Price comparison — priceDifferencePercent shows how each alternative compares to the original price
• Policy change flags — cancellationChanged and boardChanged highlight any policy differences

Key Notes

• The booking must be in CONFIRMED status.
• If the original booking is non-refundable, only non-refundable alternatives are returned (unless overridden with refundableRatesOnly).
• The nationality and currency of the original booking are used for the availability search.
• The returned prebookId values are linked to the original booking via rebookFrom and can be used immediately with POST /rates/book.

Quick Start

Provide the bookingId in the path and the new occupancies and dates in the request body. Returns an array of alternative prebook sessions.