Check the Hotel Release Notes for updates across all Hotel APIs.

Hotel Details API Reference

Get

search/propertiesdetail?chainCode={XY}&propertyCode={12345}

Use this base path if you have not yet received or not migrated to the new credentials from Travelport:

Pre-production https://api.pp.travelport.com/11/hotel/ | Production https://api.travelport.com/11/hotel/

Use this base path after you have migrated to the new credentials from Travelport (using .net instead of .com):

Pre-production https://api.pp.travelport.net/11/hotel/ | Production https://api.travelport.net/11/hotel/

Related Content: JSON Hotel APIs Guide

The Hotel Details request retrieves for a specified property a detailed description and images provided by the supplier. It is an optional request and does not need to be preceded by a search request.


Request

As part of the request requirements, also see Authentication and Common Hotel API Headers.

Query Parameters

Parameter Description Required/Optional

chainCode

String. The chain code of the requested property.

Required

propertyCode

String. The 5-character alphanumeric property code of the requested property.

Required

ImageSize

String. The size of the images to return.

Supported values:

  • Large

  • Medium

  • Small

  • Thumbnail

  • ExtraLarge

Optional

Request Body

None.


Response

For additional examples, download the developer toolkits and see Using Postman and Developer Toolkits.

The example response below returns details for property id XV-89550.

 

PropertiesResponse

Top level object for response. Includes Properties object. Properties:

transactionId: System-generated unique ID for this response. Can be used for internal tracking and troubleshooting. Not returned in all Hotel API responses.

traceId: Returned if a custom trace ID was sent in the request header.

See Identifiers in the JSON APIs for more about identifiers across the JSON Hotel APIs.

Properties

Top level object for response.

Includes PropertyInfo object.


PropertyInfo

All information returned about the requested property.

Properties:

id: Property ID composed of the chain and property codes.

Includes Property and Distance objects.


Distance


Property

Property ID information. Properties:

name: Text string for the name of the property.

id: Property ID composed of the chain and property codes.

Depending on the information returned from the supplier, may includes Rating, GeoLocation, Image, Description, BusinessService, AccessibilityFeature, GuestRoomInfo, Address, Telephone, Email, PropertyAmenity, Attraction, and CheckInOutPolicy objects.


PropertyKey

The property chain code and property code. Properties:

chainCode: Two-character code for the hotel chain.

propertyCode: Code for the property within the hotel chain.


Image

Array. Each instance is one image for the property and accompanying details including a link to the image. Key value pairs; not all may be returned:

value: The URL for the image.

dimensionCategory:Image size category. Possible values and meanings are:

  • S: Small
  • M: Medium
  • T: Thumbnail
  • L: Large

width: Image width.

height: Image height.

caption: Image caption.

pictureCategory: The image category number. Possible values and meanings are:

  • 1: exterior
  • 2: lobby
  • 3: pool
  • 4: restaurant
  • 5: health club
  • 6: guestroom
  • 7: suite
  • 8: conference room
  • 9: ballroom
  • 10: golf
  • 11: beach
  • 12: spa
  • 13: bar
  • 14: recreational
  • 21: room amenity
  • 22: property amenity
  • 23: business center

Description

A text description of the property.


AccessibilityFeature

Array. One instance for each accessibility option offered. Properties:

description: Free text description of feature.

value: OTA code for this feature.


GuestRoomInfo

Array. One instance for each type of information about the guest rooms, such as total number of rooms and number of floors. Properties:

code: OTA code for this description.

number: Number of rooms with this feature or type of information.

description: Text string for the guest room information.


Address

Property address. Properties:

City: Property city.

PostalCode: Property postal code.

Includes AddressLine, StateProv, Country, and PostalCode objects.


AddressLine

Text string for property street address.


StateProv

Property state or province. Properties:

value: The state or province code of the property address.


Country

Property country. Properties:

name: Country name.

value: Property country code.


PostalCode

String. Postal code for property address.


Telephone

Property phone number.


PropertyAmenity

Array. Each instance is a specific amenity, such as type of breakfast, spa, or pool. Properties:

description: Type of amenity.

code: OTA code for amenity.

category: Category of amenity.


BusinessService

Any business services available at the property. Properties:

code: OTA code for this type of business service.

description: Text string description of the business service.


Attraction

Array. Each instance is one attraction near the property. Properties:

name: Name of attraction.

Includes Distance object.


Distance

The distance of the attraction from the property. Properties:

value: Numeric distance.

unitOfDistance: Unit of the distance, either kilometers or miles.


CheckInOutPolicy

Property check in and out times. Properties:

checkInTime: Check in time of property.

checkOutTime: Check out time of property.

minimumAge: Minimum age to reserve room.

May include Description object.


Description

Array. Any free text related to the check in/out policy. Properties:

value: Free text provided by the supplier.

Example

                    {
 "PropertiesResponse": {
  "Properties": {
   "@type": "Properties",
   "PropertyInfo": [
    {
     "@type": "PropertyInfo",
     "id": "XV-89550",
     "Distance": {
      "value": 7.88,
      "unitOfDistance": "Miles"
     },
     "Property": {
      "@type": "PropertyDetail",
      "id": "XV-89550",
      "PropertyKey": {
       "@type": "PropertyKey",
       "chainCode": "XV",
       "propertyCode": "89550"
      },
      "name": "SpringHill Suites by Marriott Grand Rapids Airport Southeast",
      "Rating": [
       {
        "value": 3,
        "provider": "AAA"
       },
       {
        "value": 2,
        "provider": "NTM"
       },
       {
        "value": 3,
        "provider": "Booking"
       },
       {
        "value": 3,
        "provider": "GIATA"
       }
      ],
      "GeoLocation": {
       "latitude": 42.907361,
       "longitude": -85.539328
      },
      "Image": [
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/IoH3TT2Mka1A80f30dHyQ_Exterior%2025075.sh-grrse-exterior-25075:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Exterior",
        "pictureCategory": 1
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/rmTyzGxOoEmCL7x3mhovHw_Front%20Desk%2028818.sh-grrse-front-desk-28818:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Front Desk",
        "pictureCategory": 2
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/DZnrLnYf06MH9JPcud2EA_King%20Suite%20with%20Trundle35.sh-grrse-king-suite-with-trundle35-27632:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Living Space in King Suite",
        "pictureCategory": 20
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/hk1ENwtjw0W6du55mlMXFg_King%20Suite%2038581.sh-grrse-king-suite-38581-76835:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "King Suite with Trundle Sofa Bed",
        "pictureCategory": 21
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/gV0QHnjdD0aCtQPZyp2Q_%202%20Queen%20Suite%2040021.sh-grrse--2-queen-suite-40021-87546:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "2 Queen Suite with Trundle Bed Sofa",
        "pictureCategory": 21
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/QM9LbZWjPEGbMCNDKJkzxw_Trundle%20Sofa%20Bed%2026603.sh-grrse-trundle-sofa-bed-26603:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Trundle Sofa Bed",
        "pictureCategory": 21
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/hN3xeyQ7UGdVWfBCJgkeA_Standard%20Shower%2031759.sh-grrse-standard-shower-31759:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Standard Shower",
        "pictureCategory": 21
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/0NRjl0PERUyU2ewyiKTlOQ_Mobility%20Accessible%20Tub27.sh-grrse-mobility-accessible-tub27-90141:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Mobility Accessible Tub",
        "pictureCategory": 21
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/Awwr7oZc0Ost6YGntmsow_Roll%20In%20Shower%2037626.sh-grrse-roll-in-shower-37626:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Roll In Shower",
        "pictureCategory": 21
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/Py3IBs3toUaDCwBkl38yqQ_Business%20Center%2025327.sh-grrse-business-center-25327:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Business Center",
        "pictureCategory": 23
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/kz2h6lW23E6Hkj0FchBuQ_grrse-market-7009.jpg?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "The Market",
        "pictureCategory": 22
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/fiA6lQOHtkSwLBfRHXltBw_Breakfast%20Area%2027921-693.sh-grrse-breakfast-area-27921-693:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Breakfast Area",
        "pictureCategory": 4
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/KWsbKG7FZECqIi54mCjFLw_Bar%2014381.sh-grrse-bar-14381:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Bar",
        "pictureCategory": 13
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/u68yXo5qa0CRffNigxwslg_Breakfast%20Area%2027921.sh-grrse-breakfast-area-27921:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Breakfast Area",
        "pictureCategory": 4
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/JztBYpRTvkak6p6JECRNA_Pool%2038340.sh-grrse-pool-38340:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Indoor Pool",
        "pictureCategory": 3
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/0CMN1Wt9AU6TjS4KfgkWHQ_Fitness%20Center%2019355.sh-grrse-fitness-center-19355:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Fitness Center",
        "pictureCategory": 5
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/bhkEDcZbkuuotNpiifERg_Fitness%20Center%2014048.sh-grrse-fitness-center-14048:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Fitness Center",
        "pictureCategory": 5
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/kXfCXinyQESSbEemA7rbYQ_Meeting%20Space%2033659.sh-grrse-meeting-space-33659:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Meeting Space",
        "pictureCategory": 8
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/5tcq4xofrEDasmyZ7hd0A_Boardroom%2014717.sh-grrse-boardroom-14717:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "Boardroom",
        "pictureCategory": 8
       },
       {
        "value": "https://lucidcm.imgix.net/95559/Hotel/16748/Image/EJ1XnhlgzEGUE1fWYUjp7w_Queen%20Suite%20w%20Trundle2652.sh-grrse-queen-suite-w-trundle2652-91583:Classic-Hor?h=320&w=480",
        "dimensionCategory": "L",
        "caption": "2 Queen Suite with Trundle Sofa Bed",
        "pictureCategory": 21
       }
      ],
      "Description": [
       "Located minutes from the Gerald R. Ford International Airport, downtown and Lake Michigan beaches, the SpringHill Suites Grand Rapids Airport Southeast is ideal for corporate travel or fun weekend getaways. Our hotel near Grand Rapids airport offers great amenities like wireless Internet and a 24-hour food market. Up to 25% more spacious than traditional hotel rooms, our guest rooms feature separate eating and sleeping areas, pullout sofa, luxurious bedding, 32-inch TV, microwave, refrigerator, and wet bar. Staying fit is easy with our on-site fitness room and indoor pool. Start your morning with our new complimentary breakfast buffet and unwind in the evenings at our lobby bar (52fifty). When looking for affordable and spacious accommodations for short or extended stays, you will find an ideal choice at our Marriott hotel in Grand Rapids, Michigan."
      ],
      "BusinessService": [
       {
        "code": "52",
        "description": "Incoming fax complimentary"
       },
       {
        "code": "67",
        "description": "Ethernet connectivity"
       },
       {
        "code": "96",
        "description": "Meeting facilities"
       },
       {
        "code": "33",
        "description": "Telephone"
       },
       {
        "code": "34",
        "description": "Voicemail"
       },
       {
        "code": "10",
        "description": "Free toll free calls"
       },
       {
        "code": "1",
        "description": "Computer"
       },
       {
        "code": "28",
        "description": "Printer"
       },
       {
        "code": "57",
        "description": "Network/internet printing available"
       },
       {
        "code": "2",
        "description": "Copier"
       },
       {
        "code": "64",
        "description": "Post/parcel service"
       },
       {
        "code": "62",
        "description": "Overnight delivery/pickup"
       },
       {
        "code": "9",
        "description": "Fax machine"
       }
      ],
      "AccessibilityFeature": [
       {
        "value": "29",
        "description": "Service animals allowed on property for people with disabilities"
       },
       {
        "value": "69",
        "description": "Service dogs allowed"
       },
       {
        "value": "32",
        "description": "Toilet seat in guest rooms for disabled person"
       },
       {
        "value": "52",
        "description": "Raised toilet seat with grab bars"
       },
       {
        "value": "110",
        "description": "Roll-in shower available"
       },
       {
        "value": "38",
        "description": "Grab bars in bathroom"
       },
       {
        "value": "8",
        "description": "Does hotel have accessible parking?"
       }
      ],
      "GuestRoomInfo": [
       {
        "@type": "GuestRoomInfo",
        "code": "3",
        "number": 109,
        "description": "Suites"
       },
       {
        "@type": "GuestRoomInfo",
        "code": "28",
        "number": 109,
        "description": "Total rooms and suites"
       },
       {
        "@type": "GuestRoomInfo",
        "code": "2",
        "number": 109,
        "description": "Nonsmoking rooms"
       },
       {
        "@type": "GuestRoomInfo",
        "code": "5",
        "number": 3,
        "description": "Floors"
       }
      ],
      "Address": {
       "@type": "Address",
       "AddressLine": [
        "5250 28th St. SE"
       ],
       "City": "Grand Rapids",
       "StateProv": {
        "value": "MI"
       },
       "Country": {
        "value": "US",
        "name": "United States"
       },
       "PostalCode": "49512     "
      },
      "Telephone": [
       "616-464-1130",
       "464-1130"
      ],
      "Email": {
       "value": "shs.grrse.gm@test.com"
      },
      "PropertyAmenity": [
       {
        "@type": "PropertyAmenity",
        "description": "Check cashing policy",
        "code": "17",
        "category": "Banking Services"
       },
       {
        "@type": "PropertyAmenity",
        "description": "Direct dial telephone",
        "code": "109",
        "category": "Business Services"
       },
       {
        "@type": "PropertyAmenity",
        "description": "Wedding services",
        "code": "104",
        "category": "Meeting Facilities"
       },
       {
        "@type": "PropertyAmenity",
        "description": "Elevators",
        "code": "33",
        "category": "Elevators"
       },
       {
        "@type": "PropertyAmenity",
        "description": "Front desk",
        "code": "148",
        "category": "24-Hour Front Desk"
       },
       {
        "@type": "PropertyAmenity",
        "description": "24-hour front desk",
        "code": "1",
        "category": "24-Hour Front Desk"
       },
       {
        "@type": "PropertyAmenity",
        "description": "Security",
        "code": "80",
        "category": "Security Services"
       }
      ],
      "CheckInOutPolicy": {
       "checkInTime": "15:00:00"
      }
     }
    }
   ]
  },
  "traceId": "ae5f98d5-87ce-4406-8b9c-eda519d5e324"
 }
}