> For the complete documentation index, see [llms.txt](https://developer.siteminder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.siteminder.com/direct-booking-api/reference/quotes.md).

# Quotes

Returns the pricing and availability for a given property, check-in date, check-out date, occupancy and promo code.

{% hint style="info" %}
**API:** Direct Booking · **Operation:** Quotes · **Direction:** SM → Property · **Method:** Pull (Property-initiated)
{% endhint %}

## Retrieve property rate quotes

> Retrieve pricing and availability for all rates available at the property, with details broken down per date of the stay when requested.<br>

```json
{"openapi":"3.1.0","info":{"title":"Direct Booking API","version":"0.0.1"},"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-sm-api-key","in":"header"}},"schemas":{"Quote":{"type":"object","additionalProperties":false,"required":["propertyUuid","roomTypeUuid","roomRateUuid","checkInDate","checkOutDate","lengthOfStay","availability","occupancy","price","breakdown"],"properties":{"propertyUuid":{"description":"UUID of the property this quote is for.","type":"string"},"roomTypeUuid":{"description":"UUID of the room type this quote is for.","type":"string"},"roomRateUuid":{"description":"Room rate UUID","type":"string"},"checkInDate":{"description":"Check-in date passed in request","type":"string"},"checkOutDate":{"description":"Check-out date passed in request","type":"string"},"lengthOfStay":{"description":"Length of stay, based on check-in and check-out dates","type":"integer"},"availability":{"description":"Availability of the room for the length of stay.","type":"integer"},"occupancy":{"type":"object","additionalProperties":false,"required":["adults","children","infants"],"properties":{"adults":{"description":"Number of adults","type":"integer"},"children":{"description":"Number of children","type":"integer"},"infants":{"description":"Number of infants","type":"integer"}}},"price":{"type":"object","additionalProperties":false,"required":["gross","net","tax","serviceCharge"],"properties":{"gross":{"description":"Gross amount (with taxes and service charge) for the length of stay","type":"number"},"net":{"description":"Net amount (without taxes or service charge) for the length of stay","type":"number"},"tax":{"description":"Calculated tax if configured on the property.","type":"number"},"serviceCharge":{"description":"Calculated service charge amount if configured on the property.","type":"number"}}},"breakdown":{"description":"Empty unless the `withBreakdown` query parameter is set.","type":"array","items":{"$ref":"#/components/schemas/DailyBreakdown"}}}},"DailyBreakdown":{"type":"object","additionalProperties":false,"required":["date","gross","discount","promoDiscount"],"properties":{"date":{"description":"Date of stay","type":"string"},"gross":{"description":"Gross amount (with taxes and service charge) for the date","type":"number"},"discount":{"$ref":"#/components/schemas/Discount","nullable":true},"promoDiscount":{"$ref":"#/components/schemas/PromoDiscount","nullable":true}}},"Discount":{"description":"The discount / deal applied for the date","type":"object","additionalProperties":false,"required":["type","amount"],"properties":{"type":{"description":"Type of discount applied.","enum":["package-deal","stay-pay-deal","long-stay-deal"],"type":"string"},"amount":{"description":"calculated discount amount","type":"number"}}},"PromoDiscount":{"description":"The promotion discount applied for the date","type":"object","additionalProperties":false,"required":["code","amount"],"properties":{"code":{"description":"the promo code","type":"string"},"amount":{"description":"calculated discount amount","type":"number"}}}},"responses":{"BadRequest":{"description":"Bad Request","headers":{"X-SM-TRACE-TOKEN":{"description":"SiteMinder trace token","schema":{"$ref":"#/components/responses/NotFound/headers/X-SM-TRACE-TOKEN/schema"}}},"content":{"application/json":{"schema":{"$ref":"#/components/responses/NotFound/content/application~1json/schema"}}}},"NotFound":{"description":"The specified resource was not found","headers":{"X-SM-TRACE-TOKEN":{"description":"SiteMinder trace token","schema":{"type":"string","description":"Character string with length 1 to 36 and with uuid format","minLength":1,"maxLength":36,"format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["errors"],"properties":{"errors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["message","name"],"properties":{"message":{"type":"string"},"name":{"type":"string"},"meta":{"type":"object","description":"Error metadata"}}}}}}}}},"NotAuthorised":{"description":"Not Authorised","headers":{"X-SM-TRACE-TOKEN":{"description":"SiteMinder trace token","schema":{"$ref":"#/components/responses/NotFound/headers/X-SM-TRACE-TOKEN/schema"}}},"content":{"application/json":{"schema":{"$ref":"#/components/responses/NotFound/content/application~1json/schema"}}}},"AccessDenied":{"description":"Access Denied","headers":{"X-SM-TRACE-TOKEN":{"description":"SiteMinder trace token","schema":{"$ref":"#/components/responses/NotFound/headers/X-SM-TRACE-TOKEN/schema"}}},"content":{"application/json":{"schema":{"$ref":"#/components/responses/NotFound/content/application~1json/schema"}}}},"RateLimited":{"description":"Rate Limited","headers":{"X-SM-TRACE-TOKEN":{"description":"SiteMinder trace token","schema":{"$ref":"#/components/responses/NotFound/headers/X-SM-TRACE-TOKEN/schema"}}},"content":{"application/json":{"schema":{"$ref":"#/components/responses/NotFound/content/application~1json/schema"}}}},"InternalServerError":{"description":"Internal Server Error","headers":{"X-SM-TRACE-TOKEN":{"description":"SiteMinder trace token","schema":{"$ref":"#/components/responses/NotFound/headers/X-SM-TRACE-TOKEN/schema"}}},"content":{"application/json":{"schema":{"$ref":"#/components/responses/NotFound/content/application~1json/schema"}}}}},"parameters":{"apiKey":{"name":"x-sm-api-key","in":"header","schema":{"type":"string"},"required":true,"description":"API key used to authenticate the request."},"propertyUuid":{"in":"path","name":"propertyUuid","required":true,"schema":{"type":"string"},"description":"UUID for a property."},"checkIn":{"in":"query","name":"checkIn","required":true,"schema":{"type":"string"},"description":"Check-in date, e.g. '2024-08-01'."},"checkOut":{"in":"query","name":"checkOut","required":true,"schema":{"type":"string"},"description":"Check-out date, e.g. '2024-08-05' (limited to 31 nights after the check-in date)."},"adults":{"in":"query","name":"adults","required":false,"schema":{"type":"integer","default":1,"minimum":0},"description":"number of adult occupants (defaults to 1)"},"children":{"in":"query","name":"children","required":false,"schema":{"type":"integer","default":0,"minimum":0},"description":"number of child occupants (defaults to 0)"},"infants":{"in":"query","name":"infants","required":false,"schema":{"type":"integer","default":0,"minimum":0},"description":"number of infant occupants (defaults to 0)"},"withBreakdown":{"in":"query","name":"withBreakdown","required":false,"schema":{"type":"boolean"},"description":"Include the day-level price breakdown in the response."},"promocode":{"in":"query","name":"promocode","required":false,"schema":{"type":"string"},"description":"if provided, returns prices with applied promotion"}}},"paths":{"/properties/{propertyUuid}/quotes":{"get":{"tags":["pricing:read"],"operationId":"getPropertyQuotes","summary":"Retrieve property rate quotes","description":"Retrieve pricing and availability for all rates available at the property, with details broken down per date of the stay when requested.\n","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/NotAuthorised"},"403":{"$ref":"#/components/responses/AccessDenied"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalServerError"}},"parameters":[{"$ref":"#/components/parameters/apiKey"},{"$ref":"#/components/parameters/propertyUuid"},{"$ref":"#/components/parameters/checkIn"},{"$ref":"#/components/parameters/checkOut"},{"$ref":"#/components/parameters/adults"},{"$ref":"#/components/parameters/children"},{"$ref":"#/components/parameters/infants"},{"$ref":"#/components/parameters/withBreakdown"},{"$ref":"#/components/parameters/promocode"}]}}}}
```

{% hint style="success" icon="sparkles" %}

## Still have questions?

Use the <i class="fa-gitbook-assistant">:gitbook-assistant:</i> **Ask** button at the top of the page to chat with our AI assistant — it can help you navigate the guide, understand requirements, and troubleshoot issues.

If you need more support, visit [Integration Support](/integration-support/integration-support.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.siteminder.com/direct-booking-api/reference/quotes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.