---
title: "Create a reservation quote"
method: POST
path: "/api/reservations/quotes"
tags: ["Reservation quote"]
---

# Create a reservation quote

`POST /api/reservations/quotes`

Create a reservation quote to hold booking offer for certain period of time. A "default"/"standard" rate plan is supplied for properties that aren't assigned to an active [Revenue Management Rate Plan](https://help.guesty.com/hc/en-gb/articles/9365605981469-Managing-rate-plans). Ensure you only use the rate plans supplied with the quote to create your reservation.
> ❗ Important
>
> Before using the Booking Engine (BE) API reservation endpoints, ensure your Guesty account is properly activated by following these steps:
> 1. Activate Manual Source (skip this step if you already have direct reservations in Guesty account):
>    - Create a manual reservation directly in the Guesty UI. This step is required to activate the "Manual" booking source in your account.
> 2. Activate BE API Source:
>    - Create your first reservation using the Booking Engine API endpoints.
>    - This step is essential to initialize the BE API source, which allows you to set up additional fees, taxes, auto payments and automated messages.

## Request body

- object
  - `checkInDateLocalized` string, required — Localized to listing timezone reservation checkin date
  - `checkOutDateLocalized` string, required — Localized to listing timezone reservation checkout date
  - `listingId` string, required — Listing ID
  - `guestsCount` integer, required — Guests quantity
  - `numberOfGuests` object — Granular guest breakdown by type (adults, children, infants, pets)
    - `numberOfAdults` integer, required — Number of adults (must be at least 1)
    - `numberOfChildren` integer — Number of children
    - `numberOfInfants` integer — Number of infants
    - `numberOfPets` integer — Number of pets
  - `coupons` string — The list of coupon codes joined by comma

## Response `200`

successful operation

- object
  - `_id` string, required — This is a quote id for creating instant/inquiry reservation
  - `createdAt` string, date-time, required — The quote was created at
  - `expiresAt` string, date-time, required — The quote will be expired at
  - `promotions` object, required
    - `name` string
    - `type` string
    - `description` string
    - `adjustment` integer
  - `coupons` object[], required — List of coupons applied for the reservation quote
    - `name` string
    - `type` 'percentage'
    - `code` string
    - `adjustment` integer
  - `rates` object, required
    - `ratePlans` object[]
      - `ratePlan` object
        - `_id` string
        - `name` string
        - `type` string
        - `mealPlans` string[]
        - `cancellationPolicy` string[]
        - `cancellationFee` string
        - `priceAdjustment` object
          - `type` string
          - `direction` string
          - `amount` number
        - `days` object[]
          - `date` string, date
          - `price` integer
          - `currency` string
          - `basePrice` integer
          - `rateStrategy` integer
          - `ratePlan` integer
          - `lengthOfStay` integer
        - `money` object
          - `invoiceItems` object[]
            - `title` string
            - `amount` number
            - `currency` 'USD' | 'EUR' | 'AUD' | 'CAD' | 'JPY' | 'ILS' | 'GBP' | 'HKD' | 'NOK' | 'CZK' | 'BRL' | 'CHF' | 'THB' | 'ZAR' | 'MYR' | 'KRW' | 'IDR' | 'PHP' | 'INR' | 'NZD' | 'TWD' | 'PLN' | 'SGD' | 'TRY' | 'SEK' | 'VND' | 'ARS' | 'CNY' | 'DKK' | 'MXN'
            - `type` string
            - `normalType` string
            - `description` string
            - `includedTaxesList` object[] — List of taxes included in this invoice item. This field shows the included taxes that apply on the invoice item and is relevant only for users with inclusive taxes enabled.
              - …
          - `_id` string
          - `fareAccommodationAdjusted` number
          - `currency` 'USD' | 'EUR' | 'AUD' | 'CAD' | 'JPY' | 'ILS' | 'GBP' | 'HKD' | 'NOK' | 'CZK' | 'BRL' | 'CHF' | 'THB' | 'ZAR' | 'MYR' | 'KRW' | 'IDR' | 'PHP' | 'INR' | 'NZD' | 'TWD' | 'PLN' | 'SGD' | 'TRY' | 'SEK' | 'VND' | 'ARS' | 'CNY' | 'DKK' | 'MXN'
          - `fareAccommodation` number
          - `fareCleaning` number
          - `totalFees` number
          - `subTotalPrice` number
          - `hostPayout` number
          - `hostPayoutUsd` number
          - `totalTaxes` number
      - `inquiryId` string — Per-rate-plan financial quote identifier. Use this value as the inquiryId path parameter in the Retrieve Upsell endpoint.
  - `guestId` string

## Other responses

- `400` — Bad request
- `401` — Not authorized
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.dev/guesty/apis/booking-engine-api.md) · [All operations](https://skmtc.dev/guesty/apis/booking-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/guesty/booking-engine-api/revisions/90f25f70255b/schema)