---
title: "Update a reservation"
method: PUT
path: "/reservations/{id}"
tags: ["Reservations"]
---

# Update a reservation

`PUT /reservations/{id}`

Use this request to alter a guest reservation.

NOTE:
- To amend the check-in and check-out dates, please use`checkInDateLocalized` and `checkOutDateLocalized` with the format `YYYY-MM-DD`.
In this case, we do not recommend using fields `checkIn` and `checkOut` with UTC format (example `2023-01-30T10:00:00+02:00`) it might cause timezone and dates discrepancies.
- Update check-in and check-out times using `plannedArrival` and `plannedDeparture`.

IMPORTANT:
Include `ignoreCalendar` and `ignoreTerms` at your own risk. These will ignore any calendar block or listing requirement and may lead to an overbooking or unsuitable booking.

## Path parameters

- `id` string, required

## Request body

- object

## Response `200`

Retrieve the updated reservation, selection of fields that were sent in body.

- object
  - `integration` object
    - `limitations` object
      - `availableStatuses` unknown[]
        - unknown
    - `bookingCom` object
      - `invalidCreditCards` unknown[]
        - unknown
      - `reports` unknown[]
        - unknown
    - `_id` string — Unique Id
    - `platform` string
  - `guestyFeeDetails` object
    - `commission` number
    - `feeMinimum` number
    - `fee` number
    - `feeUsd` number
    - `isMinimumFee` boolean
    - `isMaximumFee` boolean
    - `planItems` unknown[]
      - unknown
  - `review` object
    - `shouldReview` boolean
  - `atTimeOfConfirmation` object
    - `snapshotCreated` boolean
    - `channelCommission` object
      - `useAccountSettings` boolean
      - `_id` string — Unique Id
      - `manual` unknown[]
        - unknown
    - `taxes` object[]
      - `appliedOnFees` string
      - `appliedByDefaultOnChannels` unknown[]
        - unknown
      - `_id` string — Unique Id
      - `name` string
      - `units` string
      - `quantifier` string
      - `amount` number
      - `appliedToAllFees` boolean
      - `type` string
    - `monthlyPriceFactor` number
    - `weeklyPriceFactor` number
    - `useAccountRevenueShare` boolean
  - `flag` boolean
  - `accountingEnabled` boolean
  - `isBMApplied` boolean
  - `confirmedPreBookings` unknown[]
    - unknown
  - `pulledByDailySync` boolean
  - `manuallyCreated` boolean
  - `_id` string — Unique Id
  - `status` string
  - `checkIn` string
  - `checkOut` string
  - `nightsCount` number
  - `guestsCount` number
  - `money` object
    - `altered` boolean
    - `invoiceItems` object[]
      - `_id` string — Unique Id
      - `title` string
      - `amount` number
      - `currency` string
      - `type` string
      - `isLocked` boolean
      - `isTax` boolean
      - `normalType` string
      - `isAutoAdditionalFee` boolean
      - `secondIdentifier` string
    - `payments` object[]
      - `authenticationRequiredData` object
        - `lastAuthMsgSentDate` string
        - `authenticationUrl` string
      - `paymentMethodStatus` string
      - `isAuthorizationHold` boolean
      - `status` string
      - `refunds` unknown[]
        - unknown
      - `authorizationHoldCaptures` unknown[]
        - unknown
      - `createdAt` string
      - `attempts` object[]
        - `createdAt` string
        - `_id` string — Unique Id
        - `status` string
        - `error` string
        - `payload` object
          - `charge` string
          - `code` string
          - `decline_code` string
          - `doc_url` string
          - `message` string
          - `payment_intent` object
            - `id` string — Unique Id
            - `object` string
            - `amount` number
            - `amount_capturable` number
            - `amount_received` number
            - `application` string
            - `capture_method` string
            - `charges` object
              - …
            - `client_secret` string
            - `confirmation_method` string
            - `created` number
            - `currency` string
            - `customer` string
            - `description` string
            - `livemode` boolean
            - `metadata` object
              - …
            - `next_action` object
              - …
            - `payment_method` string
            - `payment_method_options` object
              - …
            - `payment_method_types` unknown[]
              - …
            - `statement_descriptor` string
            - `status` string
          - `payment_method` object
            - `id` string
            - `object` string
            - `billing_details` object
              - …
            - `card` object
              - …
            - `created` number
            - `customer` string
            - `livemode` boolean
            - `type` string
          - `type` string
          - `statusCode` number
          - `requestId` string
      - `receiptTargets` unknown[]
        - unknown
      - `_id` string — Unique Id
      - `amount` number
      - `shouldBePaidAt` string
      - `paymentMethodId` string — Unique Id
      - `guestId` string — Unique Id
      - `currency` string
    - `autoPaymentsPolicy` unknown[]
      - unknown
    - `currency` string
    - `paymentProviderIds` unknown[]
      - unknown
    - `fareAccommodationAdjustment` number
    - `fareAccommodationDiscount` number
    - `fareAccommodation` number
    - `fareAccommodationAdjusted` number
    - `fareCleaning` number
    - `hostServiceFee` number
    - `hostServiceFeeTax` number
    - `hostServiceFeeIncTax` number
    - `subTotalPrice` number
    - `hostPayout` number
    - `hostPayoutUsd` number
    - `totalTaxes` number
    - `totalRefunded` number
    - `totalPaid` number
    - `paymentsDue` number
    - `balanceDue` number
    - `isFullyPaid` boolean
    - `useAccountRevenueShare` boolean
    - `netIncomeFormula` string
    - `netIncome` number
    - `commissionFormula` string
    - `commission` number
    - `commissionTaxPercentage` number
    - `commissionTax` number
    - `commissionIncTax` number
    - `ownerRevenueFormula` string
    - `ownerRevenue` number
    - `currencyConversionRateToAccount` number
    - `isTouchedPayments` boolean
  - `listingId` string — Unique Id
  - `checkInDateLocalized` string
  - `checkOutDateLocalized` string
  - `accountId` string — Unique Id
  - `guestId` string — Unique Id
  - `source` string
  - `secondarySource` string — Reservation website name. Should be present in case 'source' is one of ['BE-API', 'Booking Engine', 'website']. If absent, it means we failed to extract the secondary source information.
  - `confirmationCode` string
  - `mtl` object
    - `assigned` boolean
    - `_id` string — Unique Id
  - `isReturningGuest` boolean
  - `confirmedAt` string
  - `importedAt` string
  - `additionalFeesAtCreation` object[]
    - `automationSources` unknown[]
      - unknown
    - `_id` string — Unique Id
    - `isPercentage` boolean
    - `isAutomated` boolean
    - `name` string
    - `type` string
    - `value` number
    - `accountId` string — Unique Id
    - `multiplier` string
    - `targetFee` string
  - `createdAt` string
  - `pendingTasks` unknown[]
    - unknown
  - `customFields` unknown[]
    - unknown
  - `lastUpdatedAt` string
  - `__v` number
  - `conversationId` string — Unique Id
  - `id` string — Unique Id
  - `isMidStay` boolean
  - `lastStayListingId` string — Unique Id
  - `stay` object
    - `id` string — Unique Id
    - `checkInDateLocalized` string
    - `checkOutDateLocalized` string
    - `eta` string
    - `etd` string
    - `guestsCount` number
    - `unitTypeId` string — Unique Id
    - `unitId` string — Unique Id
    - `ratePlanId` string
    - `numberOfGuests` object
      - `numberOfAdults` number
      - `numberOfChildren` number
      - `numberOfInfants` number
      - `numberOfPets` number
    - `earlyCheckIn` object
      - `blockDay` boolean

## Other responses

- `400` — Invalid Input
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Unhandled exception. Something went wrong on server.

---

[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)