Create a reservation from quote

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

Create a reservation based on an existing quote with all the necessary reservation data. You can create a quote using the dedicated endpoint or the booking engine API.

Body Params

quoteId

string

required

The quote to convert into a reservation

status

string

required

Choose from: "inquiry", "reserved", or "confirmed"

ratePlanId

string

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

reservedUntil

string

Defaults to -1

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

guestId

string

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

guest

object

For a new guest. We recommend you create the guest first in a separate request and attach their ID to the reservation instead

ignoreCalendar

boolean

The system will check calendar availability and decline (401) 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(401) if it is. To override, set this flag to true

ignoreBlocks

boolean

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 (YYYY-MM-DDTHh.mm.ssZ). If null and status is not confirmed, leave it as null

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

Language

Credentials

Header


xxxxxxxxxx
10
1
curl --request POST \
2
     --url https://open-api.guesty.com/v1/reservations-v3/quote \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "status": "confirmed",
8
  "reservedUntil": -1
9
}
10
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success