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

# Update Reservation Guests Breakdown

`PUT /reservations-v3/{reservationId}/guests`

Update the reservation guest count, including the guest breakdown object (adults, children, infants, pets, etc.). Financial recalculation is automatically applied

## 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
  - `guestsCount` number, required — The number of guests is to be included in the reservation
  - `numberOfGuests` object — Object. Contains the breakdown of the guests
    - `numberOfChildren` number — Number of children
    - `numberOfInfants` number — Number of infants
    - `numberOfPets` number — Number of pets
    - `numberOfAdults` number, required — Number of adults

## 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
  - `guestsCount` number, required
  - `numberOfGuests` object, required
    - `numberOfChildren` number — Number of children
    - `numberOfInfants` number — Number of infants
    - `numberOfPets` number — Number of pets
    - `numberOfAdults` number, required — Number of adults

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