Pre-stay
This phase begins after the reservation has been confirmed and the guest is preparing for their upcoming stay. As the check-in date approaches, you can retrieve upcoming arrivals by searching for reservations using the arrival
and departure
parameters to filter results for a specific period.
Communication with guests
Guest Communication You may want to retrieve the guest’s email address and phone number to send a welcome message via email or SMS, or to share important pre-arrival information. Targeted communication before check-in is a great opportunity to promote offers and services that can enhance the guest’s stay—making it more enjoyable, memorable, and seamless.ee.
GET /booking/v1/reservations/{id}?expand=booker
You can choose who you want to send the notification to the booker or the guest. Take
primaryGuest.email
,primaryGuest.phone
orbooker.email
,booker.phone
fields from the response.
Email, SMS, or app notifications
Reservation Events - we send reservation events you can observe using webhooks. The ones that are important to listen are amended
, changed
, and canceled
.
Upsell Offerings - Based on the guest’s stay history, you can recommend additional services or room upgrades to enhance their experience. For more details on how to access and use this data, refer to the relevant section in the documentation Upsell integration guide.
Self-check-in - You can enable guests to check in via their smartphone before arriving at the hotel. This may include completing a digital registration card, processing payments, and handling other check-in steps—streamlining the arrival experience and reducing front desk workload.
Pre-check-in activities
Update Guest Information (Digital Registration Card) - To support digital registration and fulfill legal/statistical requirements, begin by retrieving the reservation to populate the data entry form. Once the guest has completed or updated their information—such as photo, signature, ID scan, and other relevant details—you can submit the updated data to the appropriate endpoint:
PATCH /booking/v1/reservations/{id}
We recommend you automatically verify if the guest has already stayed in the hotel before and pre-fill all the information in the digital registration card.
Add Guests - guests might want to add additional guests. You can achieve this using:
PATCH /booking/v1/reservations/{id}
Assign a Room - Before assigning a room, always check if one has already been allocated. Room assignments are often managed manually by hotel staff, and overriding them without coordination can lead to operational issues. If a room hasn’t been assigned yet, you may proceed to assign one—ensuring that your selection aligns with the hotel’s preferences and availability.
GET /booking/v1/reservations/{id}?expand=timeslices
Be cautious when handling room assignments. While the reservation response includes a unit at the top level, it’s important to also inspect the time slices for any room changes during the stay. Failing to do so may result in referencing the initial room (pre-stay), the current room (during the stay), or the final room (post-stay).
If no unit has been assigned and you need to allocate one, you can use the following endpoint to assign a random unit:
PUT /booking/v1/reservation-actions/{id}/assign-unit
Allow the Guest to Select a Room - Whether it’s a room with a view, near the elevator, or simply their favorite number, guests appreciate having a choice. To support this, you can display all available rooms along with their attributes, allowing guests to select the one that best suits their preferences:
GET /booking/v1/available-units
… and then enrich the results with the unit attributes you get for one unit:
GET /inventory/v1/units/{id}
The last thing to do, set the chosen room on the reservation:
PUT /booking/v1/reservation-actions/{id}/assign-unit/{unitId}
Offer a Room Upgrade You can enhance the guest experience by offering an upgrade to a higher room category. To do this, retrieve all available alternative offers for the reservation and identify the most suitable option. Look for offers with matching cancellation policies, guarantee conditions, or other relevant criteria. The selection logic is up to you—this is where your expertise in guest experience and upselling comes into play. You can find more details in the Upsell integration guide.
GET /booking/v1/reservations/{id}/offers
The last thing to do, set the chosen room on the reservation:
PUT /booking/v1/reservation-actions/{id}/assign-unit/{unitId}
PUT /booking/v1/reservation-actions/{id}/amend/$force
Remove City Tax If the guest is not traveling for leisure purposes, you may need to remove the city tax from the reservation. This can be done using the following endpoint:
PUT /booking/v1/reservation-actions/{id}/remove-city-tax
Check-in
Remote Check-In Enable guests to check in remotely before arriving at the property. This improves the guest experience by reducing wait times at the front desk and streamlining the arrival process.
PUT /booking/v1/reservation-actions/{id}/checkin
Check-in Kiosk If the guest prefers to check in independently using a kiosk at the hotel reception, you can fully support this experience by integrating features such as digital registration forms, payment processing via a terminal, key card activation, and more. This allows for a seamless, self-service check-in process.
PUT /booking/v1/reservation-actions/{id}/checkin