Retrieve a Quote by ID

get

https://open-api.guesty.com/v1/quotes/{quoteId}

This endpoint allows retrieval of a specific quote using its unique ID. It is used to fetch details of a previously created quote. If the quote has expired, the endpoint returns an error message indicating that the quote is expired and suggests creating a new quote.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

quoteId

string

required

The unique identifier of the quote being retrieved

Query Params

mergeAccommodationFarePriceComponents

boolean

Defaults to true

deprecated

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.

includePaymentsTemplate

boolean

Include payments template information in the response

applyGuestFacingMerges

boolean

Defaults to false

Controls whether financial items are merged into a simplified, guest-facing view.

true: Merges all backend financial breakdowns back into their base line items. Inclusive taxes merge back into original prices, while markups, deducted fees, extra person fees, and weekly/monthly discounts fold back into the main accommodation fare. This hides internal fee structures and yields a clean, customer-eligible quote.

false: Returns full, unmerged line-item transparency showing every fee, tax, and fare adjustment separately.

Note: Prefer using this parameter over mergeAccommodationFarePriceComponents, which is being deprecated. This option supersedes it by handling full financial merging rather than just fare adjustments.

Responses

400

Returned if the quoteId is missing or malformed

404

Returned if the quote with the specified ID does not exist

410

Returned if the quote has expired. The error message should indicate "Quote is expired, please create a new quote."

200Successful retrieval of the quote