---
title: "Update Reservation Dates"
method: PUT
path: "/reservations-v3/{reservationId}/dates"
tags: ["Reservations Open Api [Beta]"]
---

# Update Reservation Dates

`PUT /reservations-v3/{reservationId}/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

## Path parameters

- `reservationId` string, required

## Query parameters

- `mergeAccommodationFarePriceComponents` boolean

## Request body

- object
  - `ignoreCalendar` boolean — The system will check calendar availability and decline if unavailable unless this flag is set to true
  - `ignoreTerms` boolean — 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
  - `ignoreBlocks` boolean — Set this flag to true to ignore existing flexible blocks
  - `checkInDateLocalized` string — The reservation check-in date, localized to the property’s timezone (YYYY-MM-DD)
  - `checkOutDateLocalized` string — The reservation check-out date, localized to the property’s timezone (YYYY-MM-DD)
  - `plannedArrival` string — Use this to specify a different check-in time (Hh:mm) from the property’s default time
  - `plannedDeparture` string — Use this to specify a different check-out time (Hh:mm) from the property’s default time
  - `earlyCheckIn` object — Define if it should be marked as ‘early check-in’. E.g., true if defined, false if not
    - `blockDay` boolean — Whether day will be blocked
    - `addAdditionalFee` boolean — Whether additional fee will be added
  - `lateCheckOut` object — Define if it should be marked as ‘late check-out‘. E.g., true if defined, false if not
    - `blockDay` boolean — Whether day will be blocked
    - `addAdditionalFee` boolean — Whether additional fee will be added
  - `applyRecalculation` boolean — 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

## Response `200`

Success

- object
  - `reservationId` string, required
  - `money` object, required
    - `invoiceItems` object[], required
      - `_id` object
      - `amount` number, required
      - `currency` string
      - `isLocked` boolean
      - `normalType` string, required
      - `title` string, required
      - `type` string, required
      - `isTax` boolean
      - `isDeducted` boolean
      - `metadata` boolean
      - `evaluatedPercent` number
      - `baseAmount` number
      - `isAutoAdditionalFee` boolean
      - `secondIdentifier` string
    - `_id` object, required
    - `reservationId` string, required
    - `fareAccommodationAdjustment` number, required
    - `fareAccommodationDiscount` number, required
    - `currency` string, required
    - `fareAccommodation` number, required
    - `guestTotalPrice` number
    - `fareAccommodationAdjusted` number, required
    - `fareCleaning` number, required
    - `hostServiceFee` number, required
    - `hostServiceFeeTax` number, required
    - `hostServiceFeeIncTax` number, required
    - `subTotalPrice` number, required
    - `hostPayout` number, required
    - `hostPayoutUsd` number, required
    - `totalTaxes` number, required
    - `payments` string[], required
    - `totalRefunded` number, required
    - `totalPaid` number, required
    - `paymentsDue` number, required
    - `balanceDue` number, required
    - `isFullyPaid` boolean, required
    - `settingsSnapshot` object, required
    - `netIncomeFormula` string
    - `commissionFormula` string
    - `commissionTaxPercentage` number
    - `ownerRevenueFormula` string
    - `useAccountRevenueShare` boolean
  - `creationTime` string, date-time, required
  - `checkInDate` string, date-time, required
  - `checkOutDate` string, date-time, required

## Other responses

- `400` — Returned if required fields are missing or there is a validation error in the request body
- `422` — Returned if required fields are missing or there is a validation error in the request body
- `500` — Indicates server-side error while processing the request

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)