---
title: "Create a Quote"
method: POST
path: "/quotes"
tags: ["Quotes Open Api [Beta]"]
---

# Create a Quote

`POST /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.

## Query parameters

- `mergeAccommodationFarePriceComponents` boolean
- `includePaymentsTemplate` boolean

## Request body

- object
  - `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 — Number of guests to be included in the quote
  - `numberOfGuests` object — Keeps information on the number of guests
    - `numberOfChildren` number — Number of children in the reservation. It can be zero
    - `numberOfInfants` number — Number of infants in the reservation. It can be zero
    - `numberOfPets` number — Number of pets in the reservation. It can be zero
    - `numberOfAdults` number — Count of adults, must be > 0
  - `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

## Response `201`

Success

- object
  - `_id` string, required
  - `accountId` string, required
  - `reservationId` string
  - `status` 'valid', required
  - `guestsCount` number, required
  - `channel` 'manual_reservations' | 'owner_reservations' | 'booking_engine', required
  - `source` string, required
  - `stay` object[]
    - `numberOfGuests` object — Object. Contains the breakdown of the guests
      - `numberOfChildren` number — Number of children
      - `numberOfInfants` number — Number of infants
      - `numberOfPets` number — Number of pets
      - `numberOfAdults` number, required — Number of adults
    - `_id` object
    - `checkInDateLocalized` string, required
    - `checkOutDateLocalized` string, required
    - `guestsCount` number, required
    - `unitTypeId` object, required
    - `unitId` object
    - `ratePlanId` string
    - `eta` string, date-time, required
    - `etd` string, date-time, required
    - `earlyCheckIn` object
    - `lateCheckOut` object
  - `createdAt` string, date-time, required
  - `expiresAt` string, date-time, required
  - `unitTypeId` string, required
  - `unitId` string
  - `unassign` boolean
  - `checkInDateLocalized` string, required
  - `checkOutDateLocalized` string, required
  - `rates` object, required
  - `bookerId` string
  - `coupons` object[], required
  - `promotions` object, required
  - `alterationPayload` object
    - `dates` object
      - `checkInDateLocalized` string, required
      - `checkOutDateLocalized` string, required
    - `unit` object
      - `unitId` string
      - `unitTypeId` string, required
      - `unassign` boolean
    - `guestsCount` number
    - `ratePlanId` string
    - `reservationId` string, required
    - `status` 'confirmed' | 'reserved' | 'awaiting_payment' | 'inquiry' | 'canceled' | 'closed' | 'declined' | 'expired'
    - `numberOfGuests` object
      - `numberOfChildren` number
      - `numberOfInfants` number
      - `numberOfAdults` number, required
  - `numberOfGuests` object
    - `numberOfChildren` number — Number of children
    - `numberOfInfants` number — Number of infants
    - `numberOfPets` number — Number of pets
    - `numberOfAdults` number, required — Number of adults
  - `pointOfSale` string

## Other 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

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)