Hotel Content

How to use

This section covers the endpoints for this API and examples of how to use them.

GET details for one hotel #

This endpoint enables you to retrieve details for a hotel that you specify.

[GET] /v1/api/hotel/{id}/details

Path Parameters

The following table describes the path parameters that you must include when you query this endpoint:

Query Parameters

The following table describes the query parameters that you can include when you query this endpoint:

Note: All of the query parameters that this endpoint allows (except attributeCategory, explained above) are also allowed for the following endpoint. This endpoint also returns responses that are the same as the following endpoint. See the query parameters and response for the following endpoint for details.

▲ Back to top

GET details for multiple hotels #

This endpoint enables you to retrieve details for a list of hotels that you specify.

[GET] /v1/api/hotel/list

Query Parameters

The following table describes the elements that you can include when you query this endpoint:

The following is the list of values that you can use with the include parameter:

• Attributes: Return a list of attributes for the hotel.

• ChannelProperties: Return Channel properties of the hotel.

• ContactInfo: Return the contact information for the hotel.

• Currency: Return the default currency for the hotel.

• DiningOptions: Return a list of dining options for the hotel.

• Features: Return a list of property features for the hotel.

• HotelGroups: Return a list of Chains and Brands associated to the hotel.

• Images: Return a property level hotel image.

• Languages: Return a list of languages the hotel supports.

• LocationInfo: Return address, latitude/longitude and time zone information for the hotel.

• MealPlans: Return a list of meal plans for the hotel.

Note: Within MealPlans, the AvailableToAnyGuest attribute specifies whether the meal plan is available to all guests (true) or available to only certain groups of guests (false).

• MediaLibraryImages: Return the library of images.

• Messages: Return the messages and alerts.

• PaymentMethods: Return a list of payment methods the hotel supports.

• Recreations: Return a list of recreation information for the hotel.

• ReferencePoints: Return a list of reference points near the hotel.

• Services: Return a list of services for the hotel.

• Tier: Return the Hotel Tier Definition.

• Transportation: Return a list of Transportation for the hotel.

Response in JSON

{
  "contentLists": {
    "destinationList": [
      {
        "Id": "string",
        "Code": "string",
        "Name": "string"
      }
    ],
    "currencyList": [
      {
        "Code": "string",
        "Name": "string",
        "DecimalPlaces": 0,
        "RateOfExchange": "string",
        "Symbol": "string"
      }
    ],
    "croList": [
      {
        "Id": "string",
        "Name": "string",
        "Chain": {
          "Id": "string"
        }
      }
    ],
    "brandList": [
      {
        "Code": "string",
        "ID": "string",
        "Name": "string",
        "ChainID": "string"
      }
    ],
    "languageList": [
      {
        "Code": "string",
        "Name": "string",
        "NativeName": "string"
      }
    ],
    "paymentMethodList": [
      {
        "Code": "string",
        "Name": "string",
        "Type": "AL",
        "Category": "string",
        "IsPassThru": true
      }
    ],
    "chainList": [
      {
        "Code": "string",
        "ID": "string",
        "Name": "string"
      }
    ]
  },
  "hotelList": [
    {
      "ActiveDate": {
        "StartDate": "2026-04-30",
        "EndDate": "2026-04-30"
      },
      "AlertList": [
        {
          "Name": "string",
          "Type": "BookingInfo",
          "Details": {
            "Description": "string",
            "DetailedDescription": "string",
            "Validity": {
              "End": "2026-04-30",
              "Start": "2026-04-30"
            }
          }
        }
      ],
      "Attributes": [
        {
          "Category": "LocalPolicies",
          "Id": 0,
          "Name": "string",
          "Value": "string",
          "DataType": "string"
        }
      ],
      "BrandList": [
        {
          "ID": "string",
          "Default": true
        }
      ],
      "CROList": [
        {
          "Id": "string"
        }
      ],
      "ChainList": [
        {
          "ID": "string",
          "Primary": true
        }
      ],
      "Channels": [
        {
          "Code": "string",
          "Name": "string",
          "ParentCode": "string",
          "EnabledForDistribution": true,
          "IsDefaultGroupChannel": true,
          "IsChannelEnabledForGroups": true,
          "Properties": {
            "HotelCode": "string",
            "ChainCode": "string",
            "GoLiveDate": "2026-04-30"
          }
        }
      ],
      "ContactDetails": {
        "ContactName": "string",
        "ContactNumberList": [
          {
            "Number": "string",
            "Type": "Home"
          }
        ],
        "EmailAddress": "string",
        "Website": "string"
      },
      "Currency": {
        "Code": "string",
        "Name": "string",
        "Default": true
      },
      "DestinationList": [
        {
          "Id": "string"
        }
      ],
      "DiningOptionList": [
        {
          "Description": "string",
          "Name": "string",
          "OnProperty": true,
          "SmokingPermitted": true,
          "Distance": "string",
          "Meal": {
            "Breakfast": true,
            "Brunch": true,
            "Dinner": true,
            "Lunch": true
          },
          "Category": [
            {
              "OtaCode": "string",
              "OtaType": "string",
              "OtaDescription": "string"
            }
          ],
          "SortOrder": 0
        }
      ],
      "Location": {
        "Address": {
          "AddressLine": [
            "string"
          ],
          "City": "string",
          "CountryName": {
            "code": "string",
            "value": "string"
          },
          "PostalCode": "string",
          "StateProv": {
            "code": "string",
            "value": "string"
          }
        },
        "Latitude": "string",
        "Longitude": "string",
        "TimeZone": "string",
        "Type": "None"
      },
      "LanguageList": [
        {
          "Code": "string",
          "Default": true,
          "Primary": true
        }
      ],
      "MealPlanList": [
        {
          "Name": "Bed and Breakfast",
          "Type": "Continental",
          "Chargeable": true,
          "Description": "Breakfast included in all rates. Buffet Breakfast served in the main restaurant 6-10 am.",
          "AvailableToAnyGuest": true
        }
      ],
      "PaymentMethodList": [
        {
          "Code": "string",
          "Deposit": true,
          "Guarantee": true,
          "InUse": true,
          "IsPassThru": true
        }
      ],
      "RecreationList": [
        {
          "Type": "string",
          "OnProperty": true,
          "Distance": 0,
          "Note": "string",
          "OtaCode": "string",
          "OtaDescription": "string",
          "OtaType": "string"
        }
      ],
      "ReferencePointList": [
        {
          "Name": "string",
          "Type": "Attraction",
          "Direction": "E",
          "Distance": 0,
          "UnitOfMeasure": "None"
        }
      ],
      "RelativeLocation": {
        "AnchorLatitude": 0,
        "AnchorLongitude": 0,
        "Distance": 1000,
        "Unit": "Kilometers",
        "Orientation": "East",
        "OriginalHotel": [
          {
            "Id": "Unknown Type: int"
          }
        ]
      },
      "ServiceList": [
        {
          "OnProperty": true,
          "Note": "string",
          "Type": {
            "Code": "string",
            "Id": 0,
            "Name": "string"
          }
        }
      ],
      "PropertyFeatures": [
        {
          "Code": "string",
          "Description": "string",
          "OtaCode": "string",
          "OtaDescription": "string",
          "OtaType": "string"
        }
      ],
      "Status": "Open",
      "TerminalList": [
        {
          "Code": "string",
          "Type:": "Airport",
          "TransportationList": [
            {
              "TransportationCode": "string",
              "TransportationMethod": "Alternate",
              "OneWay": true,
              "ArrangeableByHotel": true,
              "Description": "string"
            }
          ]
        }
      ],
      "Tier": {
        "Code": "string",
        "Name": "string"
      },
      "Code": "string",
      "PmsCode": "string",
      "ID": 0,
      "Name": "string",
      "ShortName": "string",
      "ImageList": [
        {
          "Caption": "Ocean View",
          "Path": "https://hotel.cloudfront.net/imageRepo/1/OceanView.jpg",
          "Description": "Restaurant with Ocean View",
          "SortOrder": 1,
          "MediaType": "CRS",
          "MediaCategory": "Rate"
        }
      ],
      "Descriptions": [
        {
          "Name": "string",
          "Description": "string"
        }
      ]
    }
  ],
  "paging": {
    "Size": 50,
    "Start": 0,
    "Total": 146
  }
}

Response Elements

The following table explains the elements you receive in the response.

To make the response structure easier to follow, this table prefixes every element with the object and array structure that contains it, like this: ArrayOne.ArrayTwo.ArrayThree.Element

▲ Back to top