# Quotes

## Get the pricing and availability for a property

> Retrieve pricing and availability for a property with breakdown of details per date of the stay.<br>

```json
{"openapi":"3.0.0","info":{"title":"Direct Booking API","version":"0.0.1"},"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-sm-api-key","in":"header"}},"responses":{"400":{"description":"Bad Request","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InvalidInputError"}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundError"}}}},"429":{"description":"Too Many Requests","headers":{"Retry-After":{"schema":{"description":"seconds to retry after","type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnavailableError"}}}},"quote":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}}}},"schemas":{"Quote":{"type":"object","properties":{"propertyUuid":{"description":"property uuid to which the room rate belongs to.","type":"integer"},"roomTypeUuid":{"description":"roomType uuid to which the room rate belongs to.","type":"integer"},"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","description":"number of guests","properties":{"adults":{"description":"number of adults","type":"integer"},"children":{"description":"number of children","type":"integer"}}},"price":{"type":"object","description":"calculated amount for length-of-stay","properties":{"gross":{"description":"gross amount (with taxes and service charge) for the length of stay"},"net":{"description":"net amount (without taxes or service charge) for the length of stay","type":"number"},"tax":{"description":"calculated tax if configured on property.","type":"number"},"serviceCharge":{"description":"calculated service charge amount if configured on property.","type":"number"}}},"breakdown":{"description":"optional field. Only returned if withBreakdown parameter is specified in the request.","type":"array","items":{"$ref":"#/components/schemas/DailyBreakdown"}}}},"DailyBreakdown":{"type":"object","required":["date","gross"],"properties":{"date":{"description":"date of stay","type":"string"},"gross":{"description":"gross amount (with taxes or service charge) for the date","type":"number"},"discount":{"$ref":"#/components/schemas/Discount"},"promoDiscount":{"$ref":"#/components/schemas/PromoDiscount"}}},"Discount":{"description":"the discount / deal applied for the date","type":"object","properties":{"type":{"description":"type of discount (package-deal, stay-pay-deal, long-stay-deal)","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","properties":{"code":{"description":"the promo code","type":"string"},"amount":{"description":"calculated discount amount","type":"number"}}},"InvalidInputError":{"type":"object","properties":{"name":{"type":"string","enum":["InvalidInputError"]},"message":{"type":"string"}}},"UnauthorizedError":{"type":"object","properties":{"name":{"type":"string","enum":["UnauthorizedError"]},"message":{"type":"string"}}},"ForbiddenError":{"type":"object","properties":{"name":{"type":"string","enum":["ForbiddenError"]},"message":{"type":"string"}}},"ResourceNotFoundError":{"type":"object","properties":{"name":{"type":"string","enum":["ResourceNotFoundError"]},"message":{"type":"string"}}},"TooManyRequests":{"type":"object","properties":{"name":{"type":"string","enum":["TooManyRequestsError"]},"message":{"type":"string"}}},"InternalError":{"type":"object","properties":{"name":{"type":"string"},"message":{"type":"string"}}},"UnavailableError":{"type":"object","properties":{"name":{"type":"string","enum":["UnavailableError"]},"message":{"type":"string"}}}},"parameters":{"apiKey":{"name":"x-sm-api-key","in":"header","schema":{"type":"string"},"required":true,"description":"access token retrieved from Multi-Property Platform"},"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","format":"date"},"description":"check in date, e.g. '2024-08-01'"},"checkOut":{"in":"query","name":"checkOut","required":true,"schema":{"type":"string","format":"date"},"description":"check out date, e.g. '2024-08-05' (limited to 31 nights after the check in date)"},"adults":{"in":"query","name":"adults","required":true,"schema":{"type":"integer","minimum":0,"maximum":10000},"description":"number of adult occupants (defaults to 1)"},"children":{"in":"query","name":"children","required":true,"schema":{"type":"integer","minimum":0,"maximum":10000},"description":"number of child occupants (defaults to 0)"},"withBreakdown":{"in":"query","name":"withBreakdown","required":false,"schema":{"type":"boolean"},"description":"include the day level breakdown for each room"},"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":"getRoomRateQuote","summary":"Get the pricing and availability for a property","description":"Retrieve pricing and availability for a property with breakdown of details per date of the stay.\n","responses":{"200":{"$ref":"#/components/responses/quote"},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/apiKey"},{"$ref":"#/components/parameters/traceToken"},{"$ref":"#/components/parameters/propertyUuid"},{"$ref":"#/components/parameters/checkIn"},{"$ref":"#/components/parameters/checkOut"},{"$ref":"#/components/parameters/adults"},{"$ref":"#/components/parameters/children"},{"$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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
