Create a Quote

post

https://open-api.guesty.com/v1/quotes

This endpoint allows the creation of a price quote for a reservation. It requires details such as the listing ID, check-in and check-out dates, and guest count. The response includes detailed information about the quote, including rates, promotions, and applicable fees.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

mergeAccommodationFarePriceComponents

boolean

required

includePaymentsTemplate

boolean

Include payments template information in the response

boolean

Defaults to true

If set to true, Markups, ExtraPersonFee, and Discounts are hidden from both the nightly rates and invoice items—they are included within the Accommodation Fee (AF). If set to false, these components are itemized separately in the response.

Body Params

checkInDateLocalized

string

required

Localized to listing timezone reservation check-in date (YYYY-MM-DD)

checkOutDateLocalized

string

required

Localized to listing timezone reservation checkout date (YYYY-MM-DD)

listingId

string

required

Guesty listing ID

source

string

required

Define the source for getting an updated price quote

guestsCount

number

required

≥ 1

Number of guests to be included in the quote

numberOfGuests

object

Keeps information on the number of guests

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)

couponCode

string

Coupon code to be applied to the quote

Responses

400

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

Loading…

Response

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

application/json

201Success