> 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.
```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","depositType","depositAmount","creditCardSurcharges","nonGuaranteeCutoffTime","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","currency","taxes","mandatoryExtras"],"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"},"currency":{"description":"ISO 4217 three-letter currency code used for pricing at this property.","type":"string"},"taxes":{"description":"Tax breakdown for the length of stay, one line per tax. The amounts sum to `tax`.","type":"array","items":{"$ref":"#/components/schemas/Tax"}},"mandatoryExtras":{"description":"Mandatory extras charged for the length of stay, one line per extra. Already included in `gross`, `net`, `tax`, and the `taxes` lines.\n","type":"array","items":{"$ref":"#/components/schemas/MandatoryExtra"}}}},"depositType":{"type":"string","nullable":true,"enum":["full-amount","first-night","fixed-amount","percentage",null],"description":"Deposit required when booking this room rate, null when no deposit is required."},"depositAmount":{"type":"number","nullable":true,"description":"The room rate's configured deposit, not the deposit calculated for this quote. A percentage (0-100) of the gross amount when depositType is 'percentage', or a fixed amount in the property's currency when it is 'fixed-amount'. Not used for 'first-night' or 'full-amount'. Null when no deposit is required.\n"},"creditCardSurcharges":{"description":"Credit cards the property accepts, with the surcharge for paying with each. The surcharge is calculated on the amount paid by card at the time of booking (the deposit) and added to the reservation total. Property level, so identical on every quote. Empty when the property accepts no cards.","type":"array","items":{"description":"A credit card the property accepts and the surcharge for paying with it.","type":"object","additionalProperties":false,"required":["cardType","surchargePercentage"],"properties":{"cardType":{"description":"Credit card type.","type":"string","enum":["visa","mastercard","american-express","diners-club","discover","jcb","unionpay"]},"surchargePercentage":{"description":"Percentage charged on the amount paid with this card at the time of booking (the deposit), not on the quote total. 0 when the card is accepted without a surcharge.","type":"number"}}}},"nonGuaranteeCutoffTime":{"type":"string","nullable":true,"description":"Time of day, in the property's local time, before which a booking for same-day check-in does not require a card guarantee; bookings for a later check-in date don't require one either. Whole hours from '12:00' to '24:00'. Null when a card guarantee is always required.\n"},"breakdown":{"description":"Empty unless the `withBreakdown` query parameter is set.","type":"array","items":{"$ref":"#/components/schemas/DailyBreakdown"}}}},"Tax":{"description":"A single tax applied across the length of stay.","type":"object","additionalProperties":false,"required":["name","type","amount"],"properties":{"name":{"description":"Name of the tax as configured on the property.","type":"string"},"type":{"description":"Whether the tax is a percentage of the amount it applies to, or a fixed amount.","enum":["percentage","fixed"],"type":"string"},"amount":{"description":"Calculated amount for this tax across the length of stay.","type":"number"}}},"MandatoryExtra":{"description":"A single mandatory extra charged across the length of stay. Already included in `price.gross`, `price.net`, `price.tax`, and the `price.taxes` lines.\n","type":"object","additionalProperties":false,"required":["name","category","gross","net"],"properties":{"name":{"description":"Name of the extra as configured on the property.","type":"string"},"category":{"description":"How the extra is charged.","enum":["per-booking","per-room","per-room-per-night","per-person","per-person-per-night"],"type":"string"},"gross":{"description":"Calculated gross amount (with tax) for this extra across the length of stay.","type":"number"},"net":{"description":"Calculated net amount (without tax) for this extra across the length of stay.","type":"number"}}},"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 :gitbook-assistant: **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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developer.siteminder.com/direct-booking-api/reference/quotes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.