v1

latestOpenAPI 3.0.32026-07-2632131.4 MB

Reservations Open Api [Beta]

Update Reservation Dates

Change the check-in or check-out date and time for a specific reservation. Modifying the date will automatically trigger a financial recalculation, regardless of the applyRecalculation flag

put/reservations-v3/{reservationId}/dates

Path parameters

reservationIdstring required

Example:5f92cbf10cf217478ba93561

The Guesty reservation ID

Query parameters

mergeAccommodationFarePriceComponentsboolean

If set to true, Markups, ExtraPersonFee, and Discounts are hidden from both the nightly rates and invoice items—they are included within the Accommodation Fee (AF). If set to false, these components are itemized separately in the response.

Request body

ignoreCalendarboolean

The system will check calendar availability and decline if unavailable unless this flag is set to true

ignoreTermsboolean

The system will ensure the reservation accords with the terms (min, max nights, any other terms) of the property and will decline if it does not. To override, set this flag to true

ignoreBlocksboolean

Set this flag to true to ignore existing flexible blocks

checkInDateLocalizedstring

The reservation check-in date, localized to the property’s timezone (YYYY-MM-DD)

checkOutDateLocalizedstring

The reservation check-out date, localized to the property’s timezone (YYYY-MM-DD)

plannedArrivalstring

Use this to specify a different check-in time (Hh:mm) from the property’s default time

plannedDeparturestring

Use this to specify a different check-out time (Hh:mm) from the property’s default time

applyRecalculationboolean

Should the update trigger a financial recalculation? E.g., true or false. Note that altering the date will automatically apply recalculation, regardless of your choice

Example request

{
  "ignoreCalendar": true,
  "ignoreTerms": true,
  "ignoreBlocks": true,
  "checkInDateLocalized": "2024-01-01",
  "checkOutDateLocalized": "2024-01-02",
  "plannedArrival": "11:00",
  "plannedDeparture": "15:00"
}

Response

Success

reservationIdstring required

creationTimestring date-time required

checkInDatestring date-time required

checkOutDatestring date-time required

Example response

{
  "money": {
    "invoiceItems": [
      {
        "title": "Cleaning fee",
        "amount": 20,
        "currency": "USD",
        "type": "CLEANING_FEE",
        "isLocked": true,
        "normalType": "CF"
      }
    ]
  }
}