> 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/property.md).
# Property
Return detailed information for a specific property contained in your group.
{% hint style="info" %}
**API:** Direct Booking · **Operation:** Property · **Direction:** SM → Property · **Method:** Pull (Property-initiated)
{% endhint %}
## Retrieve property details
> Retrieve detailed information for a property.
```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":{"Property":{"type":"object","additionalProperties":false,"required":["uuid","name","latitude","longitude","timezone","currencyIsoCode","bookingEngineUrl","address","description","termsAndConditions","instructionsToLocation","features","policies","photos"],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the property in the SiteMinder Direct Booking product."},"name":{"type":"string","description":"The property name as it appears in the SiteMinder Direct Booking product."},"latitude":{"type":"number","description":"Geographic latitude of the property."},"longitude":{"type":"number","description":"Geographic longitude of the property."},"timezone":{"type":"string","description":"IANA time zone identifier for the property (e.g. Australia/Sydney)."},"currencyIsoCode":{"type":"string","description":"ISO 4217 three-letter currency code used for pricing at this property."},"bookingEngineUrl":{"type":"string","nullable":true,"format":"uri","description":"URL to the property's booking engine."},"description":{"type":"string","nullable":true,"description":"The property description as it appears in the SiteMinder Direct Booking product."},"termsAndConditions":{"type":"string","nullable":true,"description":"The property's terms and conditions"},"instructionsToLocation":{"type":"string","nullable":true,"description":"Directions or instructions for reaching the property."},"address":{"type":"object","additionalProperties":false,"description":"The property's full address.","required":["addressLine1","addressLine2","suburb","state","postcode","country"],"properties":{"addressLine1":{"type":"string","description":"Primary street address"},"addressLine2":{"type":"string","nullable":true,"description":"Secondary address information (e.g. suite, apartment, floor)"},"suburb":{"type":"string","description":"Suburb or locality"},"state":{"type":"string","description":"State or province"},"postcode":{"type":"string","description":"Postal or zip code"},"country":{"type":"string","nullable":true,"description":"Country where the property is located"}}},"features":{"type":"object","additionalProperties":false,"description":"property amenities grouped by category, each an empty array when the property has no amenities in that category","required":["facilities","parking","transport"],"properties":{"facilities":{"type":"array","items":{"$ref":"#/components/schemas/Property/properties/features/properties/parking/items"}},"parking":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["otaCode","name"],"properties":{"otaCode":{"type":"integer","format":"int32","description":"OTA amenity code"},"name":{"type":"string","description":"English name of the amenity"}}}},"transport":{"type":"array","items":{"$ref":"#/components/schemas/Property/properties/features/properties/parking/items"}}}},"policies":{"type":"object","additionalProperties":false,"description":"Property policies. Always present; individual policies are always present with null fields when unset.","required":["smokingPolicy","checkInCheckOut"],"properties":{"smokingPolicy":{"type":"object","additionalProperties":false,"description":"smoking policy derived from property amenities. Every field is true or null, never false. All three are null when none of OTA codes 312, 198 and 268 are present. When OTA code 312 is present, nonSmokingRooms and allPublicAreasNonSmoking are always null.\n","required":["smokeFreeProperty","nonSmokingRooms","allPublicAreasNonSmoking"],"properties":{"smokeFreeProperty":{"type":"boolean","nullable":true,"description":"property is smoke-free (OTA code 312)"},"nonSmokingRooms":{"type":"boolean","nullable":true,"description":"property offers non-smoking rooms (OTA code 198)"},"allPublicAreasNonSmoking":{"type":"boolean","nullable":true,"description":"all public areas of the property are non-smoking (OTA code 268)"}}},"checkInCheckOut":{"type":"object","additionalProperties":false,"description":"Check-in and check-out time windows. Always present; individual time fields are null when unset.","required":["checkInStartTime","checkInEndTime","checkOutStartTime","checkOutEndTime","restrictedCheckInCheckOut"],"properties":{"checkInStartTime":{"type":"string","nullable":true,"description":"Earliest check-in time, format HH:MM"},"checkInEndTime":{"type":"string","nullable":true,"description":"Latest check-in time, format HH:MM"},"checkOutStartTime":{"type":"string","nullable":true,"description":"Earliest check-out time, format HH:MM"},"checkOutEndTime":{"type":"string","nullable":true,"description":"Latest check-out time, format HH:MM"},"restrictedCheckInCheckOut":{"type":"boolean","description":"True when the property enforces both a latest check-in time and an earliest check-out time"}}}}},"photos":{"type":"array","description":"Property-level photos, ordered by their stored position ascending with unpositioned photos last. Empty array when the property has no photos.\n","items":{"type":"object","additionalProperties":false,"required":["url","caption","sortOrder"],"properties":{"url":{"type":"string","format":"uri","description":"Public URL of the photo"},"caption":{"type":"string","nullable":true,"description":"Caption for the photo, null when none is set"},"sortOrder":{"type":"integer","format":"int32","nullable":true,"description":"Display order, starting at 1 and contiguous across photos that have a stored position. Null for photos with no stored position; these always come last.\n"}}}}}}},"responses":{"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"}}}},"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"}}}}}}}}},"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."}}},"paths":{"/properties/{propertyUuid}":{"get":{"tags":["property:read"],"operationId":"getProperty","summary":"Retrieve property details","description":"Retrieve detailed information for a property.\n","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Property"}}}},"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"}]}}}}
```
{% 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 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/property.md?ask=&goal=
```
`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.