API Reference
Start typing to search…

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
string
required

The quote to convert into a reservation

string
enum
required

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

string

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

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

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

boolean

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

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

boolean

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

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

string
length ≤ 50

Define the confirmation code

string
length ≤ 50

The origin of the reservation

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

Updated 3 months ago

Language
Credentials
Header
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 3 months ago