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

# 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.\
>

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"Direct Booking API","version":"0.0.1"},"paths":{"/properties/{propertyUuid}/quotes":{"get":{"tags":["pricing:read"],"security":[{"apiKey":[]}],"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":{"description":"OK","content":{"application/json":{"schema":{"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":{"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":{"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"}}}}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","enum":["InvalidInputError"]},"message":{"type":"string"}}}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","enum":["UnauthorizedError"]},"message":{"type":"string"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","enum":["ForbiddenError"]},"message":{"type":"string"}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","enum":["ResourceNotFoundError"]},"message":{"type":"string"}}}}}},"429":{"description":"Too Many Requests","headers":{"Retry-After":{"schema":{"description":"seconds to retry after","type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","enum":["TooManyRequestsError"]},"message":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","enum":["UnavailableError"]},"message":{"type":"string"}}}}}}},"parameters":[{"name":"x-sm-api-key","in":"header","schema":{"type":"string"},"required":true,"description":"access token retrieved from Multi-Property Platform"},{"$ref":"#/components/parameters/traceToken"},{"in":"path","name":"propertyUuid","required":true,"schema":{"type":"string"},"description":"uuid for a property"},{"in":"query","name":"checkIn","required":true,"schema":{"type":"string","format":"date"},"description":"check in date, e.g. '2024-08-01'"},{"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)"},{"in":"query","name":"adults","required":true,"schema":{"type":"integer","minimum":0,"maximum":10000},"description":"number of adult occupants (defaults to 1)"},{"in":"query","name":"children","required":true,"schema":{"type":"integer","minimum":0,"maximum":10000},"description":"number of child occupants (defaults to 0)"},{"in":"query","name":"withBreakdown","required":false,"schema":{"type":"boolean"},"description":"include the day level breakdown for each room"},{"in":"query","name":"promoCode","required":false,"schema":{"type":"string"},"description":"if provided, returns prices with applied promotion"}]}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-sm-api-key","in":"header"}},"parameters":{"traceToken":false}}}
```
