Property

Get detailed information and room rates for a specific property that satisfies the given search criteria. This endpoint provides more comprehensive data about a single property, including its room types and available rates.

get

/properties/{uuid}

Path parameters

uuidstringrequired

The unique identifier of the property

Query parameters

checkinstring · daterequired

The arrival date. Must be within 500 days in the future and in the format yyyy-mm-dd.

checkoutstring · daterequired

The departure date. Must be later than checkin. Must be between 1 and 30 days after checkin. Must be within 500 days in the future and in the format yyyy-mm-dd.

roomsobject[]

totalAdultsinteger · max: 655350

Specify the total number of adults across all rooms. Must also specify totalRooms field. Do not use this if searching with the occupants rooms list.

totalChildreninteger · max: 655350

Specify the total number of children across all rooms. Must also specify totalRooms field. Do not use this if searching with the occupants rooms list.

totalRoomsinteger · min: 1 · max: 10

Specify the total number of rooms. Must also specify totalAdults and/or totalChildren fields. Do not use this if searching with the occupants rooms list.

dealCodestring

Only return rates associated with the given deal code

languagestring · enum

Specify the preferred language for returned content. Falls back to the property's default language if unavailable.

Options: de, en, es, fr, id, it, pt, th

Header parameters

x-sm-api-idstringrequired

The api id for channel

x-sm-api-keystringrequired

The api key for channel

Responses

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/properties/{uuid}?checkin=2025-02-28&checkout=2025-02-28' \
  --header 'x-sm-api-id: text' \
  --header 'x-sm-api-key: text'

200

400

401

404

429

500

200

{
  "uuid": "text",
  "name": "text",
  "propertyType": {
    "text": "text",
    "language": "text"
  },
  "description": {
    "text": "text",
    "language": "text"
  },
  "address": "text",
  "suburb": "text",
  "state": "text",
  "country": "text",
  "email": "text",
  "phoneNumber": "text",
  "language": "text",
  "latitude": 1,
  "longitude": 1,
  "checkinStartTime": "text",
  "checkinEndTime": "text",
  "checkoutEndTime": "text",
  "starRating": 1,
  "currency": "text",
  "totalCommissionPercentage": 1,
  "siteminderCommissionPercentage": 1,
  "channelCommissionPercentage": 1,
  "specialConditions": {
    "taxExemptions": [
      {
        "name": "is-nz-gst-opt-out"
      }
    ]
  },
  "photos": [
    {
      "url": "https://example.com",
      "captions": "text"
    }
  ],
  "amenities": [
    {
      "text": "text",
      "language": "text"
    }
  ],
  "acceptedCardTypes": [
    "AX"
  ],
  "roomTypes": [
    {
      "uuid": "text",
      "name": {
        "text": "text",
        "language": "text"
      },
      "description": {
        "text": "text",
        "language": "text"
      },
      "roomArea": "text",
      "photos": [
        {
          "url": "https://example.com",
          "captions": "text"
        }
      ],
      "amenities": [
        {
          "text": "text",
          "language": "text"
        }
      ],
      "views": [
        {
          "text": "text",
          "language": "text"
        }
      ],
      "bedConfigurations": [
        {
          "bedCode": {
            "text": "text",
            "language": "text"
          },
          "quantity": 1
        }
      ],
      "roomRates": [
        {
          "uuid": "text",
          "ratePlanUuid": "text",
          "ratePlanName": "text",
          "breakfastIncluded": true,
          "totalPrice": 1,
          "adults": 1,
          "children": 1,
          "cancellationPolicy": {
            "freeCancellationUntilDays": 1,
            "policyType": "non-refundable"
          },
          "dealCode": "text",
          "totalCommissionPercentage": 1,
          "siteminderCommissionPercentage": 1,
          "channelCommissionPercentage": 1,
          "lowInventory": true,
          "taxes": [
            {
              "name": "text",
              "amount": 1
            }
          ],
          "fees": [
            {
              "name": "text",
              "amount": 1
            }
          ]
        }
      ]
    }
  ]
}

Successful response