---
title: "Create a new quote."
method: POST
path: "/v2/quotes"
tags: ["Quotes"]
---

# Create a new quote.

`POST /v2/quotes`

## Request body

- QuoteEditModel
  - `adults` integer — The quoted number of adults.
  - `arrival` string, date-time — The quoted date of arrival in property time zone in yyyy-MM-dd format, e.g. 2024-10-31.
  - `check_in` string, nullable — The quoted arrival checkin time in property time zone in 24 hour HH:mm format, e.g. 16:00. (NULL use property default)
  - `check_out` string, nullable — The quoted departure checkout time in property time zone in 24 hour HH:mm format, e.g. 09:00. (NULL use property default)
  - `children` integer — The quoted number of children.
  - `departure` string, date-time — The quoted date of departure in property time zone in yyyy-MM-dd format, e.g. 2024-10-31.
  - `discount_code` string, nullable — Optional discount code to apply to the quote.
  - `expires_utc` string, date-time, nullable — The date this quote expires (UTC). Omit or null to use property default (QuoteExpirationDays).
  - `generate_charges` boolean — Whether to generate charges on the quote. Default is true. For PATCH, when true, charges will be regenerated (reset).
  - `generate_email` boolean — Whether to generate and send email system messages after creating the quote. Default is false.
  - `guest_id` integer — The ID of the guest this quote was created for.
  - `hold_dates` boolean — Whether to create a hold block for the quoted dates. Default is false.
  - `infants` integer — The quoted number of infants.
  - `listing_site_id` integer, nullable — The listing site this quote is attributed to. Use the Id from the listing sites endpoints.
  - `notes` string, nullable — Notes about this quote.
  - `pets` integer — The quoted number of pets.
  - `property_id` integer — The quoted property ID.
  - `test` boolean — Indicates that the generated quote should be returned only, not stored. When true, the quote operation (POST/PATCH) will be validated and processed (including charge generation if requested) but not committed to the database. Default is false.
  - `validate_rules` boolean — Whether to validate property rules (min/max nights, etc.). Default is true.

## Response `200`

A model representing the quote created.

- QuoteViewModel
  - `id` integer — The ID of this record.
  - `tags` string[] — A collection of tag names.
  - `adults` integer — The quoted number of adults.
  - `arrival` string, date-time — The quoted date of arrival.
  - `charges` QuoteChargeModel[] — Collection of charges associated with this quote.
    - `amount` number
    - `description` string
    - `is_channel_managed` boolean
    - `is_taxable` boolean
    - `position` integer
    - `rate` number
    - `rate_is_percent` boolean
    - `surcharge_id` integer, nullable
    - `tax_id` integer, nullable
    - `type` 'rent' | 'surcharge' | 'tax' | 'tax_other' | 'surcharge_other'
  - `check_in` string — The quoted arrival checkin time.
  - `check_in_end` string — The quoted arrival checkin end time.
  - `check_out` string — The quoted departure checkout time.
  - `children` integer — The quoted number of children.
  - `created_utc` string, date-time — The date this quote was created in the system.
  - `departure` string, date-time — The quoted date of departure.
  - `expires_utc` string, date-time — The date this quote expires.
  - `guest` GuestPartialModel — Partial details about the guest. For full details, use the guests endpoint.
    - `id` integer — The ID of this record.
    - `first_name` string
    - `last_name` string
  - `guest_id` integer — The ID of the guest this quote was created for.
  - `infants` integer — The quoted number of infants.
  - `key` string, guid — A globally unique ID for this quote.
  - `listing_site` string — The listing site this quote is attributed to.
  - `notes` string — Notes about this quote.
  - `pets` integer — The quoted number of pets.
  - `platform_email_address` string — A proxy email address provided by the OTA specifically for this quote.
  - `property_id` integer — The quoted property ID.
  - `quoted_utc` string, date-time — The date this quote was made.
  - `thread_ids` integer[]
  - `updated_utc` string, date-time, nullable — The date this quote was last updated in the system.

---

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