Retrieve any combination of hotel and room amenities, property information, suppliers, property images, and more for a single hotelId.
Note that the options element for the room and hotel lists request can return some or all of the same information as this standalone request.

Request Formats
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/info?
XML Parent Element: <HotelInformationRequest>

Request Parameters

Base Parameters
Name Value Required Description
apiExperience string yes

Use this attribute to identify the origin of your request. Choose an applicable value from the set provided below for each request you send.

Values:
PARTNER_CALL_CENTER - request from an agent in your call center
PARTNER_WEBSITE - request from a customer-facing website
PARTNER_MOBILE_WEB - request from a mobile-formatted website
PARTNER_MOBILE_APP - request from a mobile app
PARTNER_BOT_CACHE - request from a cache bot
PARTNER_BOT_REPORTING - request from a reporting bot
PARTNER_AFFILIATE - request from an API/platform that serves your own affiliate base

hotelId long yes Specify the hotel desired for the request.
options string no Specify how much or what kind of data to return.  Send a single value or a combination of values in a comma delimited list.
Values:
DEFAULT Retrieve all hotel information data from the supplier resources. If options are not specified or omitted from the request, all available data is returned.  This is equivalent to sending each of the separate options listed at once.
HOTEL_SUMMARY Retrieve only the hotel summary
HOTEL_DETAILS Retrieve only the hotel details
SUPPLIERS Retrieve only the suppiers for this property
ROOM_TYPES Retrieve only the property room types
ROOM_AMENITIES Retrieve only the room amenities list
PROPERTY_AMENITIES Retrieve only the property amenities list
HOTEL_IMAGES Retrieve only the hotel image URLs
Returns the hotel data specifically requested via the options element, or all available data if no options were specified in the request.

Details for the hotel data returned are arranged below as they return within each option.

Hotel Information Response
Parent Element: HotelInformationResponse


Depending on the options specified in the request, any or all of the information requested will return within the following objects and arrays.
All arrays have a single attribute of size to denote the number of results they contain.
Name Value Description
HotelSummary object Summary elements for the property returned
HotelSummary.hotelId long Confirms the value sent in the request
HotelSummary.name string Name of the hotel
HotelSummary.address1 string Hotel street address
HotelSummary.city string Hotel city
HotelSummary.stateProvinceCode string Two character code for the state/province containing the specified city. Returns only for US, CA, and AU country codes.

References:
US State Codes
Canadian Province/Territory Codes
Australian Province/Territory Codes
  • Australian Capital - AC
  • New South Wales - NW
  • Northern Territory - NO
  • Queensland - QL
  • South Australia - SA
  • Tasmania - TS
  • Victoria - VC
  • Western Australia - WT
HotelSummary.countryCode string Two character ISO-3166 code for the country the hotel is located in.
HotelSummary.postalCode string Postal code for the hotel
HotelSummary.airportCode string Airport code associated with the hotel. Typically not returned.
HotelSummary.propertyCategory int Category of the property returned.

Values:
1: hotel
2: suite
3: resort
4: vacation rental/condo
5: bed & breakfast
6: all-inclusive
HotelSummary.hotelRating float Rating (0-5) for the hotel. A value of 0.0 or a blank value indicate none is available.
HotelSummary.hotelRatingDisplay string Returns Star or Alternate to indicate the source and required display type for the hotelRating value.

Currently, only points of sale in Australia must follow the provided display indicators. Additional jurisdictions will be added in the future.

Star indicates the rating is provided by the hotel's local star rating authority. Use stars to display hotelRating.

Alternate indicates hotelRating is an Expedia-assigned value; an official rating was not available. Use an alternate display, e.g. circles or squares, to indicate it is not an official rating from a local authority.

Returns for minorRev=30 and above only.
HotelSummary.locationDescription string General location as entered by the property, e.g. "Near Pike Place Market"
HotelSummary.lowRate string Do not use this field. This value is no longer maintained.
HotelSummary.highRate string Do not use this field. This value is no longer maintained.
HotelSummary.rateCurrencyCode string Currency code of the high or low rates returned.
HotelSummary.latitude float Latitude coordinate for the hotel.
HotelSummary.longitude float Longitude coordinate for the hotel.
HotelDetails object Detail elements for the property returned.
HotelDetails.numberOfRooms int Total number of rooms at the property
HotelDetails.numberOfFloors int Number of floors in the property.
HotelDetails.checkInTime string Hotel check-in time
HotelDetails.checkOutTime string Hotel check-out time
HotelDetails.extraPersonCharge float Typical charge for an extra person (over room occupancy)
HotelDetails.propertyInformation string Free text entered by the property
HotelDetails.areaInformation string Nearby attractions/areas, often including distances from the property.
HotelDetails.propertyDescription string Description free text entered by the property
HotelDetails.hotelPolicy string Do not use this field. Value is always blank. General hotel policy text.
HotelDetails.depositCreditCardsAccepted string Credit cards accepted for deposit/immediate payment, if known.
HotelDetails.roomInformation string Hotel room information. Typically contains notifications and fees.
HotelDetails.drivingDirections string Do not use this field. This content is no longer maintained.
HotelDetails.checkInInstructions string Contains info for extra person fees, ID requirements, and any other notices relevant to check-in.
HotelDetails.specialCheckInInstructions string Contains information critical for check-in, such as a requirement to notify the property of an expected arrival time. Display this information in the same area as the primary check-in instructions.
HotelDetails.locationDescription string Describes the property's grounds and relative location in the city. Returns for minorRev=25 and above only.
HotelDetails.diningDescription string Describes dining accommodations at the property. Returns for minorRev=25 and above only.
HotelDetails.amenitiesDescription string Describes general building amenities at the property. Returns for minorRev=25 and above only.
HotelDetails.
businessAmenitiesDescription
string Describes any business-specific amenities at the property, e.g. conference rooms. Returns for minorRev=25 and above only.
HotelDetails.roomDetailDescription string Describes typical room amenities. Returns for minorRev=25 and above only.
HotelDetails.roomFeesDescription string Describes any fees or deposits specific to the room. Returns for minorRev=25 and above only.
HotelDetails.mandatoryFeesDescription string Describes resort fees and other mandatory taxes or charges. May describe which services are covered by any fees, such as fitness centers or internet access. Returns for minorRev=25 and above only.
HotelDetails.
nationalRatingsDescription
string States the source of the property's star rating (e.g. a regional or national tourism agency) and any other ratings claimed. Returns for minorRev=25 and above only.
HotelDetails.
knowBeforeYouGoDescription
string Provides additional disclaimers deemed necessary by the property. Returns for minorRev=25 and above only.
HotelDetails.
renovationsDescription
string Describes any recent room or property renovations. Returns for minorRev=25 and above only.
Suppliers container for Supplier array Has size attribute to indicate the number of suppliers returned
Suppliers.Supplier n/a

Element contains no values.
Each element contains attributes chainCode and ID to identify a single supplier where the hotel is active.
The values for ID can be decoded as follows:
13: Expedia.com properties

 

RoomTypes container for RoomType array Contains array of available room type at the property. Has size attribute to indicate the number of results contained.
RoomTypes.RoomType array Contains information for a single room type. Has attributes roomTypeId and roomCode. roomCode corresponds with the roomTypeCode element returned in the room and list responses.
RoomType.description string Short description for the room.
RoomType.descriptionLong string Longer room description, if available.
RoomType.roomAmenities container for RoomAmenity array Contains all provided amenities for the room. Has size attribute to indicate the number of results contained.
roomAmenities.RoomAmenity array Contains description element for a single amenity. Has attribute amenityId. Refer to the AttributeList file for mapping amenityId values.
RoomAmenity.amenity string Description for the amenity.
PropertyAmenities container for PropertyAmenity array Contains the amenities available at the property (not room-specific). Has size attribute to indicate the number of results contained.
PropertyAmenities.PropertyAmenity array Contains description element for a single amenity. Has attribute amenityId. Refer to the AttributeList file for mapping amenityId values.
PropertyAmenity.amenity string Description for the amenity.
HotelImages container for HotelImage array Contains all property images available. Does not contain room-level photos. Has size attribute to indicate the number of results contained.
Review  image categorizations for more specific details about the data returned.
HotelImages.HotelImage array Contains elements for the URL and reference values for a single image.
HotelImage.highResolutionUrl string URL for the high resolution version of the image, if provided.
HotelImage.hotelImageId long id for the specific hotel image
HotelImage.name string name of the image, if entered by the property
HotelImage.category int Category ID for the image, if entered by the property.
HotelImage.type int Indicates if the image is a thumbnail, map, etc. caption is used more often by most properties.
HotelImage.caption string Description for the image
HotelImage.url string Full URL for the image
HotelImage.thumbnailUrl string URL to a thumbnail of the image, if provided.
HotelImage.highResolutionUrl string URL for the high resolution version of the image, if provided.
HotelImage.supplierId long Indicates the supplier of the image. Follows the same mapping as the Supplier element's ID attribute.
HotelImage.width long Width of the image in pixels
HotelImage.height long Height of the image in pixels
HotelImage.byteSize long Size of the image, if available.