Sign in

v1

latestOpenAPI 3.0.02026-07-26190104.7 KB
Reservation quote

Create a reservation quote

Create a reservation quote to hold booking offer for certain period of time. A "default"/"standard" rate plan is supplied for properties that aren't assigned to an active Revenue Management Rate Plan. Ensure you only use the rate plans supplied with the quote to create your reservation.

❗ Important

Before using the Booking Engine (BE) API reservation endpoints, ensure your Guesty account is properly activated by following these steps:

  1. Activate Manual Source (skip this step if you already have direct reservations in Guesty account):
    • Create a manual reservation directly in the Guesty UI. This step is required to activate the "Manual" booking source in your account.
  2. Activate BE API Source:
    • Create your first reservation using the Booking Engine API endpoints.
    • This step is essential to initialize the BE API source, which allows you to set up additional fees, taxes, auto payments and automated messages.
post/api/reservations/quotes

Request body

checkInDateLocalizedstring required

Localized to listing timezone reservation checkin date

checkOutDateLocalizedstring required

Localized to listing timezone reservation checkout date

listingIdstring required

Listing ID

guestsCountinteger required

Guests quantity

couponsstring

The list of coupon codes joined by comma

Example request

{
  "checkInDateLocalized": "2022-12-28",
  "checkOutDateLocalized": "2023-01-15",
  "listingId": "5bf544a600a9b000389f81d8",
  "guestsCount": 1,
  "numberOfGuests": {
    "numberOfAdults": 2,
    "numberOfChildren": 1
  },
  "coupons": "DISCOUNT_50_$,DISCOUNT_60_$"
}

Response

successful operation

_idstring required

This is a quote id for creating instant/inquiry reservation

createdAtstring date-time required

The quote was created at

expiresAtstring date-time required

The quote will be expired at

guestIdstring