Create a Reservation Without a Quote

post

https://open-api.guesty.com/v1/reservations-v3

Create a reservation without needing a quote. When the listing doesn't have an active rate plan assigned, a default rate plan is selected. Otherwise, the first active rate plan is selected.

Body Params

checkInDateLocalized

string

required

The reservation check-in date, localized to the property’s timezone (YYYY-MM-DD)

checkOutDateLocalized

string

required

The reservation check-out date, localized to the property’s timezone (YYYY-MM-DD)

listingId

string

required

The property’s ID as defined in Guesty

source

string

required

Define the source for getting an updated price quote

status

string

enum

required

Define the reservation status

guestId

string

The primary ID for returning guests and new guests that were created beforehand

guest

object

For a new guest, note that we recommend that you create the guest first in a separate request and add their guestId to the reservation instead

guestsCount

number

required

Number of guests to be included in the quote

numberOfGuests

object

Total number of guests with breakdown

couponCode

string

A single coupon code defined under the accounted Revenue Management settings

ratePlanId

string

The ID of an active rate plan when you wish to apply it to the reservation

accommodationFare

number

≥ 0

Override the accommodation fare with a fixed amount. Must be zero or greater. This will override the calculated nightly rates.

cleaningFee

number

≥ 0

Add a cleaning fee with a fixed amount. Must be zero or greater.

applyPromotions

boolean

Defaults to true

Apply account promotions setup (if toggled off (false), do not take promotions when creating a reservation)

ignoreCalendar

boolean

Defaults to false

The system will check calendar availability and decline (401) if unavailable unless this flag is set to true

ignoreTerms

boolean

Defaults to false

The system will ensure the reservation accords with the terms (min, max nights, any other terms) of the property and will decline(401) if it is. To override, set this flag to true

ignoreBlocks

boolean

Defaults to false

Set this flag to true to ignore existing flexible blocks (advance notice, preparation time, etc)

confirmedAt

date-time

Define the confirmation date. If null and status is confirmed, use the current date. If null and status is not confirmed, leave it as null

reservedUntil

number

enum

It can be -1 (no limit), 0.17 (10 minutes), 0.25 (15 minutes), 0.5 (30 minutes), or 24/48/72 hours when the reservation is a booking request that reserves dates (i.e., status = “reserved”)

confirmationCode

string

length ≤ 50

Define the confirmation code

origin

string

length ≤ 50

The origin of the reservation

originId

string

length ≤ 50

The origin id of the reservation

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

201Success