v1

latestOpenAPI 3.0.32026-07-2632131.4 MB

Reservations

Update a reservation

Use this request to alter a guest reservation.

NOTE:

To amend the check-in and check-out dates, please usecheckInDateLocalized 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.

put/reservations/{id}

Path parameters

idstring required

Reservation ID

Request body

object required

Response

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

flagboolean

accountingEnabledboolean

isBMAppliedboolean

pulledByDailySyncboolean

manuallyCreatedboolean

_idstring

Unique Id

statusstring

checkInstring

checkOutstring

nightsCountnumber

guestsCountnumber

listingIdstring

Unique Id

checkInDateLocalizedstring

checkOutDateLocalizedstring

accountIdstring

Unique Id

guestIdstring

Unique Id

sourcestring

secondarySourcestring

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.

confirmationCodestring

isReturningGuestboolean

confirmedAtstring

importedAtstring

createdAtstring

lastUpdatedAtstring

__vnumber

conversationIdstring

Unique Id

idstring

Unique Id

isMidStayboolean

lastStayListingIdstring

Unique Id

Example response

{
  "integration": {
    "_id": "563e0b6a08a2710e00057b82"
  },
  "atTimeOfConfirmation": {
    "channelCommission": {
      "_id": "563e0b6a08a2710e00057b82"
    },
    "taxes": [
      {
        "_id": "563e0b6a08a2710e00057b82"
      }
    ]
  },
  "_id": "563e0b6a08a2710e00057b82",
  "checkIn": "2021-08-17T07:00:00.000Z",
  "checkOut": "2021-08-17T07:00:00.000Z",
  "money": {
    "invoiceItems": [
      {
        "_id": "563e0b6a08a2710e00057b82"
      }
    ],
    "payments": [
      {
        "authenticationRequiredData": {
          "lastAuthMsgSentDate": "2021-08-16T08:38:20.280Z"
        },
        "createdAt": "2021-08-16T08:38:20.280Z",
        "attempts": [
          {
            "createdAt": "2021-08-16T08:38:20.280Z",
            "_id": "563e0b6a08a2710e00057b82",
            "payload": {
              "payment_intent": {
                "id": "563e0b6a08a2710e00057b82",
                "charges": {
                  "data": [
                    {
                      "metadata": {
                        "accountId": "563e0b6a08a2710e00057b82",
                        "reservationId": "563e0b6a08a2710e00057b82",
                        "listingId": "563e0b6a08a2710e00057b82"
                      }
                    }
                  ]
                },
                "metadata": {
                  "accountId": "563e0b6a08a2710e00057b82",
                  "reservationId": "563e0b6a08a2710e00057b82",
                  "listingId": "563e0b6a08a2710e00057b82"
                }
              }
            }
          }
        ],
        "_id": "563e0b6a08a2710e00057b82",
        "shouldBePaidAt": "2021-08-16T08:38:20.280Z",
        "paymentMethodId": "563e0b6a08a2710e00057b82",
        "guestId": "563e0b6a08a2710e00057b82"
      }
    ]
  },
  "listingId": "563e0b6a08a2710e00057b82",
  "accountId": "563e0b6a08a2710e00057b82",
  "guestId": "563e0b6a08a2710e00057b82",
  "mtl": {
    "_id": "563e0b6a08a2710e00057b82"
  },
  "confirmedAt": "2021-08-17T07:00:00.000Z",
  "importedAt": "2021-08-17T07:00:00.000Z",
  "additionalFeesAtCreation": [
    {
      "_id": "563e0b6a08a2710e00057b82",
      "accountId": "563e0b6a08a2710e00057b82"
    }
  ],
  "createdAt": "2021-08-17T07:00:00.000Z",
  "lastUpdatedAt": "2021-08-17T07:00:00.000Z",
  "conversationId": "563e0b6a08a2710e00057b82",
  "id": "563e0b6a08a2710e00057b82",
  "lastStayListingId": "563e0b6a08a2710e00057b82",
  "stay": {
    "id": "563e0b6a08a2710e00057b82",
    "unitTypeId": "563e0b6a08a2710e00057b82",
    "unitId": "563e0b6a08a2710e00057b82"
  }
}