Hotels operations

/hotels

Returns the list of hotels that matches the requested parameters.

Operation path: /hotels/

Request

Request parameters

Parameter Type Description
fields String The list of fields to be received in the response. If nothing is specified, the hotelCode is returned. See below for the complete list. "All" returns all fields available.
codes String

Filter for a specific hotel or list of hotels.

destinationCode String

Filter to limit the results for an specific destination.

countryCode String Filter to limit the results for an specific country.
lastUpdateTime String

Specifying this parameter will limit the results to those modified or added after the date specified. The allowed format is YYYY-MM-DD

language String Language Code in which you want the descriptions to be returned. If not specifically indicated, English is the default language.
from String Number of the initial record to receive, if nothing is indicated 1 is the default value.
to String Number of the final record to receive, if nothing is indicated 100 is the default value.
useSecondaryLanguage String "True" if you want to receive the descriptions in English if the description is not available in the language requested.
"False" (default value) if you dont want to receive the description in English if the language requested is not available. 

Request examples

https://api.test.hotelbeds.com/hotel-content-api/1.0/hotels?fields=name%2Cdescription%2CcountryCode%2CdestinationCode&destinationCode=PMI&language=ENG&from=1&to=100

https://api.test.hotelbeds.com/hotel-content-api/1.0/hotels?fields=all&language=ITA&from=125&to=250

https://api.test.hotelbeds.com/hotel-content-api/1.0/hotels?lastUpdateTime=2015-09-10&destinationCode=PAR&language=ENG&from=5000&to=6000

 

Available fields

As mentioned above, by using the "all" value in the fields parameter you will receive all the available fields in the response, but you can limit the size of the response selecting just the fields you want to receive in the response:

  • all
  • name
  • description
  • countryCode
  • destinationCode
  • zoneCode
  • coordinates
  • categoryCode
  • chainCode
  • license
  • address
  • postalCode
  • city
  • email
  • giataCode
  • acommodationTypeCode
  • phones
  • rooms
  • images
  • boardCodes
  • facilities
  • segmentCodes
  • web
  • terminals
  • issues
  • interestPoints
  • wildcards

You can use more than one field separating each value with a comma:

https://api.test.hotelbeds.com/hotel-content-api/1.0/hotels?fields=code,name,city,address

 

Response

Response parameters

Node/Attribute Type Max Size KEY Description
hotelsRS Element Occurrences 1 No Key Top level
hotelsRS/from Integer 8 No Key Record# origin of the response
hotelsRS/to Integer 8 No Key Record# end of the response
hotelsRS/total Integer 8 No Key Total available records
hotelsRS/auditData Element Occurrences 1 No Key Relevant internal information
hotelsRS/auditData/@processTime String Occurrences 1 No Key Server process time in milliseconds
hotelsRS/auditData/@timestamp String Occurrences 1 No Key Date/time when the requests has been processed. Always returned at Spanish time
hotelsRS/auditData/@requestHost String Occurrences 1 No Key IP From where the petition was sent to the system
hotelsRS/auditData/@serverId String Occurrences 1 No Key Server code or ID(It is for internal use)
hotelsRS/auditData/@environment String Occurrences 1 No Key Environment where the request has been sent and processed
hotelsRS/auditData/@release String Occurrences 1 No Key Internal Release information
hotelsRS/hotels Array of Hotel elements Occurrences 1 No Key List of hotels
hotelsRS/hotels/hotel Hotel element Occurrences 0..* No Key Top level
hotelsRS/hotels/hotel/@code Integer 8 Key Internal Hotel Code
hotelsRS/hotels/hotel/@countryCode String 3 Key Internal Country code
hotelsRS/hotels/hotel/@destinationCode String 3 Key Internal destination code, where the hotel is located
hotelsRS/hotels/hotel/@categoryCode String 5 No Key Hotel rating based on the information provided by the hotel
hotelsRS/hotels/hotel/@categoryGroupCode String 5 No Key Group name of the category to which the hotel belongs
hotelsRS/hotels/hotel/@chainCode String 5 No Key Code of the chain that the hotel belongs to
hotelsRS/hotels/hotel/@accommodationTypeCode String 8 Key Hotel Type Code it will indicate the type of the hotel (apartment, hotel, home)
hotelsRS/hotels/hotel/@web String 100 No Key Website URL of the hotel or the chain
hotelsRS/hotels/hotel/@S2C String 100 No Key Health & Safety rating (NOTE: please bear in mind is not related to hotel category)
hotelsRS/hotels/hotel/name String 100 No Key Multilanguage name of the hotel
hotelsRS/hotels/hotel/description String 4000 No Key Description of the hotel
hotelsRS/hotels/hotel/zoneCode Integer 8 Key Code of the Zone within the destination
hotelsRS/hotels/hotel/coordinates Element Occurrences 0..1 No Key GPS coordinates of the hotel
hotelsRS/hotels/hotel/coordinates/@longitude Float 25 digits (20 of them can be decimals) No Key Longitude of the hotel
hotelsRS/hotels/hotel/coordinates/@latitude Float 25 digits (20 of them can be decimals) No Key Latitude of the hotel
hotelsRS/hotels/hotel/boardCodes Array of Board Codes Occurrences 0..* String 7 Characters No Key List of the board types offered at the hotel
hotelsRS/hotels/hotel/boardCodes/boardCode String 7 No Key Board type offered at the hotel
hotelsRS/hotels/hotel/segmentCodes Array of segment codes Occurrences 1 No Key List of the internal segment codes
hotelsRS/hotels/hotel/segmentCodes/segmentCode String 3 Characters Occurrences 0..* No Key Code of the segment to which the hotel belongs (Business hotel, city hotel,...)
hotelsRS/hotels/hotel/address String Occurrences 0..1 No Key Multilanguage address of the hotel
hotelsRS/hotels/hotel/postalCode String 10 No Key Postal code
hotelsRS/hotels/hotel/city String Occurrences 0..1 No Key Multilanguage city of the hotel
hotelsRS/hotels/hotel/@email String 100 No Key E-mail address
hotelsRS/hotels/hotel/phones Array of Phones Occurrences 1 No Key The list of contact phones of the hotel
hotelsRS/hotels/hotel/phones/phone Phone element Occurrences 0..* No Key Details of the phone
hotelsRS/hotels/hotel/phones/@phoneNumber String 50 Key Phone number
hotelsRS/hotels/hotel/phones/@phoneType String 50 Key Type of phone line (phonebooking, phonehotel, fax...)
hotelsRS/hotels/hotel/rooms Array of Rooms Occurrences 1 No Key List of available rooms at the hotel
hotelsRS/hotels/hotel/rooms/room Room element Occurrences 0..* No Key Information of the hotel room
hotelsRS/hotels/hotel/rooms/room@roomCode String "Room type code.Characteristics": 18 Key Identifier of the room type
hotelsRS/hotels/hotel/rooms/room@characteristicCode String 2 No Key Characteristic code/s of the room, ex: Standard, etc.
hotelsRS/hotels/hotel/rooms/room/roomFacilities Array of room facilities Occurrences 0..* No Key List of facilities, amenities and installations in the room of the hotel.
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility Array of room facilities Occurrences 0..* No Key
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@facilityCode Integer 3 Key Code of the Facility
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@order Integer 8 Key Order of facility in case there is more than one facility at the hotel
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@number Double 9 No Key Numeric value of the facility
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@indYesOrNo Boolean No Key Indicator if the mandatory facility exists at the hotel or not
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@indLogic Boolean No Key Indicator if the facility exists at the hotel or not
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@indFee Boolean No Key Indicator if the facility has cost or not at the establishment
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@amount Float 15 digits (5 can be decimals) No Key Amount of the facility fee
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@currency String 3 No Key Currency of the facility fee
hotelsRS/hotels/hotel/rooms/room/roomFacilities/roomFacility@applicationType String 2 No Key Application type of the facility fee
hotelsRS/hotels/hotel/rooms/room/roomStays Array of Stays Occurrences 1 No Key List of the different departments in which the room is divided
hotelsRS/hotels/hotel/rooms/room/roomStays/roomStay Stay Element Occurrences 0..* No Key Describes one of the departments in which the room is divided
hotelsRS/hotels/hotel/rooms/room/roomStays/roomStay/@stayType String 10 Key Code of the Department Type
hotelsRS/hotels/hotel/rooms/room/roomStays/roomStay/@order String 3 Key Numeric position of the department within the room
hotelsRS/hotels/hotel/rooms/room/roomStays/roomStay/@description String 50 No Key Description of the type of department
hotelsRS/hotels/hotel/facilities Array of hotel facilities Occurrences 1 No Key List of facilities, amenities and installations in the hotel.
hotelsRS/hotels/hotel/facilities/facility Facility element Occurrences 0..* No Key Information of a facility, amenity or installation in the hotel.
hotelsRS/hotels/hotel/facilities/facility/@facilityCode Integer 3 Key Code of the Facility
hotelsRS/hotels/hotel/facilities/facility/@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotelsRS/hotels/hotel/facilities/facility/@order Integer 8 Key Order of facility in case there is more than one facility at the hotel
hotelsRS/hotels/hotel/facilities/facility/@number Integer 9 No Key Numeric value of the facility
hotelsRS/hotels/hotel/facilities/facility/@indLogic Boolean No Key Indicator if the facility exists at the hotel or not
hotelsRS/hotels/hotel/facilities/facility/@indFee Boolean No Key Indicator if the facility has cost or not at the establishment
hotelsRS/hotels/hotel/facilities/facility/@distance Integer 9 No Key Distance in meters to the facility
hotelsRS/hotels/hotel/facilities/facility/@ageFrom Integer 3 No Key Minimum age to access the facility
hotelsRS/hotels/hotel/facilities/facility/@ageTo Integer 3 No Key Maximum age to access the facility
hotelsRS/hotels/hotel/facilities/facility/@textValue String 100 No Key Text value of the facility
hotelsRS/hotels/hotel/facilities/facility/@dateFrom Date Format YYYY-MM-DD HH:MM:SS No Key Date from when the facility is valid
hotelsRS/hotels/hotel/facilities/facility/@dateTo Date Format YYYY-MM-DD HH:MM:SS No Key Date untilthe facility is valid
hotelsRS/hotels/hotel/facilities/facility/@timeFrom Date Format YYYY-MM-DD HH:MM:SS No Key Time fromwherethe facility is valid
hotelsRS/hotels/hotel/facilities/facility/@timeTo Date Format YYYY-MM-DD HH:MM:SS No Key Time until the facility is valid
hotelsRS/hotels/hotel/facilities/facility/@indYesOrNo Boolean No Key Indicator if the mandatory facility exists at the hotel or not
hotelsRS/hotels/hotel/facilities/facility/@amount Float 15 digits (5 can be decimals) No Key Amount of the facility fee
hotelsRS/hotels/hotel/facilities/facility/@currency String 3 No Key Currency of the facility fee
hotelsRS/hotels/hotel/facilities/facility/@applicationType String 2 No Key Application type of the facility fee
hotelsRS/hotels/hotel/terminals Array of terminals Occurrences 1 No Key List of terminals associated to the hotel and their distance to the hotel.
hotelsRS/hotels/hotel/terminals/terminal Terminal element Occurrences 0..* No Key Information of a terminal associated to the hotel and their distance to the hotel.
hotelsRS/hotels/hotel/terminals/terminal/@terminalCode String 5 Key Terminal code
hotelsRS/hotels/hotel/terminals/terminal/@terminalType Char 1 Key Type of the terminal: A (airport), T (train station)....
hotelsRS/hotels/hotel/terminals/terminal/@distance Float 5 digits (1 of them can be decimal) No Key Distance in kilometers to the hotel
hotelsRS/hotels/hotel/terminals/terminal/name String 50 Key Name of the terminal
hotelsRS/hotels/hotel/terminals/terminal/description String 50 Key Description of the terminal
hotelsRS/hotels/hotel/interestPoints Array of Points of Interest Occurrences 1 No Key List of points of interest close to the hotel
hotelsRS/hotels/hotel/interestPoints/interestPoint Array of Points of Interest Occurrences 0..* No Key Description of a point of interest close to the hotel
hotelsRS/hotels/hotel/interestPoints/interestPoint/@facilityCode Integer 3 Key Code of the Facility
hotelsRS/hotels/hotel/interestPoints/interestPoint/@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotelsRS/hotels/hotel/interestPoints/interestPoint/@order Integer 8 Key Order of facility in case there is more than one facility at the hotel
hotelsRS/hotels/hotel/interestPoints/interestPoint/@poiName String 50 No Key Internal description of the point of interest.
hotelsRS/hotels/hotel/interestPoints/interestPoint/@indFee Boolean No Key Indicator if the facility has cost or not at the establishment
hotelsRS/hotels/hotel/interestPoints/interestPoint/@distance Integer 9 No Key Distance in meters to the point of interest
hotelsRS/hotels/hotel/images Array of images Occurrences 1 No Key List of hotel pictures
hotelsRS/hotels/hotel/images/image Image element Occurrences 0..* No Key Hotel picture
hotelsRS/hotels/hotel/images/image/@path String 100 Key URL of the image. For hotel images, we do not return the full path. Note that one of the following paths must be added by the client.
hotelsRS/hotels/hotel/images/image/@imageTypeCode String 4 Key Specifies where has the picture been taken (you can see the possible values in the response of types/imagetypes operation).
hotelsRS/hotels/hotel/images/image/@order Integer 5 Key Order in which the images are shown in the web page
hotelsRS/hotels/hotel/images/image/@roomCode String

For unified clients "Room type code.Characteristics": 18

For non Unified clients "Room type code–Company code": 7

Key Identifier of the room type
hotelsRS/hotels/hotel/images/image/@roomType String 3 No Key Internal Room type code, returned only for Unified clients.
hotelsRS/hotels/hotel/images/image/@characteristicCode String 15 Key for Non Unified clients, No Key for Unified clients Characteristic code/s of the room

XML schema

<?xml version="1.0" encoding="UTF-8"?>
<hotelsRS xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<from>0</from>
	<to>0</to>
	<total>0</total>
	<auditData 
		processTime=""
		timestamp=""
		requestHost=""
		serverId=""
		environment=""
		release=""/>
	<hotels>
		<hotel 
			code="" 
			countryCode="" 
			destinationCode="" 
			categoryCode="" 
			categoryGroupCode="" 
			chainCode="" 
			accommodationTypeCode="" 
			web="" 
			S2C="">
			<name></name>
			<description></description>
			<zoneCode>0</zoneCode>
			<coordinates longitude="" latitude=""/>
			<boardCodes>
				<boardCode>0</boardCode>
			</boardCodes>
			<segmentCodes>
				<segmentCode>0</segmentCode>
			</segmentCodes>
			<address></address>
			<postalCode></postalCode>
			<city></city>
			<email></email>
			<license></license>
			<phones>
				<phone>
					<phoneNumber>0</phoneNumber>
					<phoneType></phoneType>
				</phone>
			</phones>
			<rooms>
				<room roomCode="" characteristicCode="">
					<roomFacilities>
						<roomFacility facilityCode="" facilityGroupCode="" number="" indYesOrNo=""/>
					</roomFacilities>
					<roomStays>
						<roomStay stayType="" order="" description=""/>
					</roomStays>
				</room>
			</rooms>
			<facilities>
				<facility facilityCode="" facilityGroupCode="" order="" indLogic="" indFee="" indYesOrNo="" number="" distance=""/>
			</facilities>
			<terminals>
				<terminal terminalCode="" distance=""/>
			</terminals>
			<interestPoints>
				<interestPoint facilityCode="" facilityGroupCode="" order="" poiName="" distance=""/>
			</interestPoints>
			<images>
				<image imageTypeCode="" path="" roomCode="" characteristicCode="" order=""/>
			</images>
		</hotel>
	</hotels>
</hotelsRS>
		

JSON schema

{
	"from": 0,
	"to": 0,
	"total": 0,
	"auditData": {
		"processTime": "",
		"timestamp": "",
		"requestHost": "",
		"serverId": "",
		"environment": "",
		"release": ""
	},
	"hotels": [{
		"code": 0,
		"name": {
			"languageCode": "",
			"content": ""
		},
		"accommodationTypeCode": "",
		"countryCode": "",
		"destinationCode": "",
		"zoneCode": "",
		"coordinates": {
			"longitude": 0,
			"latitude": 0
		},
		"categoryCode": "",
		"chainCode": "",
		"description": {
			"languageCode": "",
			"content": ""
		},
		"address": {
			"languageCode": "",
			"content": ""
		},
		"postalCode": "",
		"city": {
			"languageCode": "",
			"content": ""
		},
		"email": "",
		"web": "",
		"giataCode": "",
		"license": "",
		"phones": [{
			"phoneType": "",
			"phoneNumber": ""
		}],
		"issues": [{
			"issueCode": "",
			"issueType": "",
			"alternative": false,
			"order": 0,
			"dateFrom": "",
			"dateTo": ""
		}],
		"terminals": [{
			"terminalCode": "",
			"distance": 0
		}],
		"facilities": [{
			"facilityCode": 0,
			"facilityGroupCode": 0,
			"order": 0,
			"number": "",
			"indLogic": false,
			"indFee": false,
			"distance": "",
			"ageFrom": "",
			"ageTo": "",
			"textValue": "",
			"dateFrom": "",
			"dateTo": "",
			"timeFrom": "",
			"timeTo": "",
			"indYesOrNo": false,
			"amount": "",
			"currency": "",
			"applicationType": ""
		}],
		"boardCodes": [""],
		"segmentCodes": [""],
		"interestPoints": [{
			"facilityCode": 0,
			"facilityGroupCode": 0,
			"order": 0,
			"poiName": "",
			"indFee": false,
			"distance": 0
		}],
		"rooms": [{
			"roomCode": "",
			"roomType": "",
			"characteristicCode": "",
			"roomFacilities": [{
				"facilityCode": 0,
				"facilityGroupCode": 0,
				"order": 0,
				"number": "",
				"indYesOrNo": false,
				"indLogic": false,
				"indFee": false,
				"amount": "",
				"currency": "",
				"applicationType": ""
			}],
			"roomStays": [{
				"stayType": "",
				"description": "",
				"order": "",
				"facilityList": [{
					"facilityCode": 0,
					"facilityGroupCode": 0,
					"number ": ""
				}]
			}]
		}],
		"wildcards": [{
			"roomCode": "",
			"roomType": "",
			"characteristicCode": "",
			"hotelRoomDescription": {
				"languageCode": "",
				"content": ""
			}
		}],
		"images": [{
			"imageTypeCode": "",
			"path": "",
			"order": 0,
			"roomCode": "",
			"roomType": "",
			"characteristicCode": ""
		}]
	}]
}
		

 

/hotels/details

Returns all the information associated to a specific hotel. Its intended use is to get the hotel details when the hotel is not in the local database due it was created after the last updating process of your local database.

Operation path: /hotels/{hotel_code}

Request

Request parameters

Parameter Type Description
hotel_code String

Code of the hotel to retrieve the details.

language String Language Code in which you want the descriptions to be returned. If not specifically indicated, English is the default language.
useSecondaryLanguage String "True" if you want to receive the descriptions in English if the description is not available in the language requested. "False" (default value) if you dont want to receive the description in English if the language requested is not available. 

Request examples

https://api.test.hotelbeds.com/hotel-content-api/1.0/hotels/1?language=ENG

https://api.test.hotelbeds.com/hotel-content-api/1.0/hotels/62458?language=ITA&useSecondaryLanguage=true

 

Response

Response parameters

Node/Attribute Type Max Size KEY Description
hotelDetailsRS/auditData Element Occurrences 1 No Key Relevant internal information
hotelDetailsRS/auditData@processTime String Occurrences 1 No Key Server process time in milliseconds
hotelDetailsRS/auditData@timestamp String Occurrences 1 No Key Date/time when the requests has been processed. Always returned at Spanish time
hotelDetailsRS/auditData@requestHost String Occurrences 1 No Key IP From where the petition was sent to the system
hotelDetailsRS/auditData@serverId String Occurrences 1 No Key Server code or ID(It is for internal use)
hotelDetailsRS/auditData@environment String Occurrences 1 No Key Environment where the request has been sent and processed
hotelDetailsRS/auditData@release String Occurrences 1 No Key Internal Release information
hotelDetailsRS/hotel Element Occurrences 1 No Key Top level
hotelDetailsRS/hotel@code Integer 8 Key Internal Hotel Code
hotelDetailsRS/hotel@web String 100 No Key Website URL of the hotel or the chain
hotelDetailsRS/hotel@S2C String 100 No Key Health & Safety rating (NOTE: please bear in mind is not related to hotel category)
hotelDetailsRS/hotel@giataCode Double 15 No Key Giata code of the hotel, returned only if the client has agreement with Giata
hotelDetailsRS/hotel/name Element Occurrences 0..1 No Key Multilanguage name of the hotel
hotelDetailsRS/hotel/description Element Occurrences 0..1 No Key Multilanguage description of the hotel
hotelDetailsRS/hotel/description@languageCode String 3 No Key Language in which the content is returned
hotelDetailsRS/hotel/country Element Occurrences 0..1 Key Country element
hotelDetailsRS/hotel/country@code String 3 Key Internal Country code
hotelDetailsRS/hotel/country@isoCode String 3 Key Country ISO code
hotelDetailsRS/hotel/country/description String 50 Key Multilanguage description of the country
hotelDetailsRS/hotel/destination Element Occurrences 0..1 Key Destination element
hotelDetailsRS/hotel/destination@code String 3 Key Internal destination code, where the hotel is located
hotelDetailsRS/hotel/destination@countryCode String 3 Key Country ISO code of the destination where the hotel is located
hotelDetailsRS/hotel/destination/name String 50 Key Multilanguage name of the destination
hotelDetailsRS/hotel/zone Element Occurrences 0..1 Key Zone element
hotelDetailsRS/hotel/zone@zoneCode String 3 Key Internal zone code, where the hotel is located
hotelDetailsRS/hotel/zone@name String 50 Key Name of the zone where the hotel is located
hotelDetailsRS/hotel/coordinates Element Occurrences 0..1 No Key GPS coordinates of the hotel
hotelDetailsRS/hotel/coordinates@longitude Float 25 digits (20 of them can be decimals) No Key Longitude of the hotel
hotelDetailsRS/hotel/coordinates@latitude Float 25 digits (20 of them can be decimals) No Key Latitude of the hotel
hotelDetailsRS/hotel/category Element Occurrences 0..1 No Key Category element
hotelDetailsRS/hotel/category@code String 5 No Key Hotel rating code based on the information provided by the hotel
hotelDetailsRS/hotel/category/description String 5 No Key Multilanguage description of the hotel rating
hotelDetailsRS/hotel/categoryGroup Element Occurrences 0..1 No Key Category group element
hotelDetailsRS/hotel/categoryGroup@code String 5 No Key Code of the categoryGroup of the hotel
hotelDetailsRS/hotel/categoryGroup/description String 5 No Key Multilanguage description of the hotel categoryGroup
hotelDetailsRS/hotel/chain Element Occurrences 0..1 No Key Chain element
hotelDetailsRS/hotel/chain@code String 5 No Key Code of the chain that the hotel belongs to
hotelDetailsRS/hotel/accommodationType Element Occurrences 0..1 Key AccommodationType element
hotelDetailsRS/hotel/accommodationType@code String 8 Key Hotel Type Code it will indicate the type of the hotel (apartment, hotel, home)
hotelDetailsRS/hotel/accommodationType@typeDescription String 8 Key Multilanguage description of the hotel type
hotelDetailsRS/hotel/boards Array of board elements Occurrences 0..1 No Key List of boards offered at the hotel
hotelDetailsRS/hotel/boards/board Board element Occurrences 0..* No Key Board type offered at the hotel
hotelDetailsRS/hotel/boards/board@code String 7 Characters No Key Internal code of the board
hotelDetailsRS/hotel/boards/board/description String 50 No Key Multilanguage description of the board
hotelDetailsRS/hotel/boards/board/description@languageCode String 3 No Key Language in which the content is returned
hotelDetailsRS/hotel/segments Array of segment elements Occurrences 0..1 No Key List of segments
hotelDetailsRS/hotel/segments/segment Segment element Occurrences 0..* No Key Segment info of the hotel
hotelDetailsRS/hotel/segments/segment@code String 7 Characters No Key Internal code of the segment
hotelDetailsRS/hotel/segments/segment/description String 50 No Key Multilanguage description of the segment
hotelDetailsRS/hotel/address String Occurrences 0..1 No Key Multilanguage address of the hotel
hotelDetailsRS/hotel/address@languageCode String 3 No Key Language in which the content is returned
hotelDetailsRS/hotel/postalCode String 10 No Key Postal code
hotelDetailsRS/hotel/city String Occurrences 0..1 No Key Multilanguage city of the hotel
hotelDetailsRS/hotel/city@languageCode String 3 No Key Language in which the content is returned
hotelDetailsRS/hotel/email String 100 No Key E-mail address
hotelDetailsRS/hotel/phones Array of Phones Occurrences 0..1 No Key The list of contact phones of the hotel
hotelDetailsRS/hotel/phones/phone Phone element Occurrences 0..* No Key Details of the phone
hotelDetailsRS/hotel/phones/phone@phoneNumber String 50 Key Phone number
hotelDetailsRS/hotel/phones/phone@phoneType String 50 Key Type of phone line (phonebooking, phonehotel, fax...)
hotelDetailsRS/hotel/rooms Array of room elements Occurrences 0..1 No Key List of available rooms at the hotel
hotelDetailsRS/hotel/rooms/room Room element Occurrences 0..* No Key Information of the hotel room
hotelDetailsRS/hotel/rooms/room@roomCode String 18 Key Identifier code of the room
hotelDetailsRS/hotel/rooms/room@description String 50 Key Multilanguage description of the room
hotelDetailsRS/hotel/rooms/room/type Type element Occurrences 0..1 No Key Information of the hotel room type
hotelDetailsRS/hotel/rooms/room/type@code String 18 Key Identifier code of the room type
hotelDetailsRS/hotel/rooms/room/type/description String 50 No Key Multilanguage description of the room type
hotelDetailsRS/hotel/rooms/room/characteristic Characteristic element Occurrences 0..1 No Key Information of the hotel room characteristic
hotelDetailsRS/hotel/rooms/room/characteristic@code String 2 No Key Identifier code of the room characteristic
hotelDetailsRS/hotel/rooms/room/characteristic/description String 50 No Key Multilanguage description of the room characteristic
hotelDetailsRS/hotel/rooms/room/roomFacilities Array of roomFacility elements Occurrences 0..1 No Key List of facilities, amenities and installations in the room of the hotel.
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility roomFacility element Occurrences 0..* No Key Information of the facility, amenity or installation in the room of the hotel.
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@facilityCode Integer 3 Key Code of the Facility
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@order Integer 8 Key Order of facility in case there is more than one facility at the hotel
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@number Double 9 No Key Numeric value of the facility
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@indYesOrNo Boolean No Key Indicator if the mandatory facility exists at the hotel or not
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@indLogic Boolean No Key Indicator if the facility exists at the hotel or not
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@indFee Boolean No Key Indicator if the facility has cost or not at the establishment
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@amount Float 15 digits (5 can be decimals) No Key Amount of the facility fee
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@currency String 3 No Key Currency of the facility fee
hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility@applicationType String 2 No Key

Application type of the facility fee:

PN – Per Person & Night

PS – Per Person & Stay

UH – Per Unit & Hour

UN – Per Unit & Night

US – Per Unit & Stay

hotelDetailsRS/hotel/rooms/room/roomFacilities/roomFacility/description String 100 No Key Multilanguage description of the roomFacility.
hotelDetailsRS/hotel/rooms/room/roomStays Array of Stays Occurrences 0..* No Key List of the different departments in which the room is divided
hotelDetailsRS/hotel/rooms/room/roomStays/roomStay@stayType String 10 Key Code of the Department Type
hotelDetailsRS/hotel/rooms/room/roomStays/roomStay@order Integer 3 Key Order of the Department Type
hotelDetailsRS/hotel/rooms/room/roomStays/roomStay@description String 50 No Key Description of the type of department
hotelDetailsRS/hotel/rooms/room/roomStays/roomStay@stayPosition Integer 3 Key Numeric position of the department within the room
hotelDetailsRS/hotel/facilities Array of hotel facilities Occurrences 0..1 No Key List of facilities, amenities and installations in the hotel.
hotelDetailsRS/hotel/facilities/facility Hotel facility element Occurrences 0..* No Key Info of facility, amenity or installation in the hotel.
hotelDetailsRS/hotel/facilities/facility@facilityCode Integer 3 Key Code of the Facility
hotelDetailsRS/hotel/facilities/facility@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotelDetailsRS/hotel/facilities/facility@order Integer 8 Key Order of facility in case there is more than one facility at the hotel
hotelDetailsRS/hotel/facilities/facility@number Integer 9 No Key Numeric value of the facility
hotelDetailsRS/hotel/facilities/facility@indLogic Boolean No Key Indicator if the facility exists at the hotel or not
hotelDetailsRS/hotel/facilities/facility@indFee Boolean No Key Indicator if the facility has cost or not at the establishment
hotelDetailsRS/hotel/facilities/facility@distance Integer 9 No Key Distance in meters to the facility
hotelDetailsRS/hotel/facilities/facility@ageFrom Integer 3 No Key Minimum age to access the facility
hotelDetailsRS/hotel/facilities/facility@ageTo Integer 3 No Key Maximum age to access the facility
hotelDetailsRS/hotel/facilities/facility@textValue String 100 No Key Text value of the facility
hotelDetailsRS/hotel/facilities/facility@dateFrom Date Format YYYY-MM-DD HH:MM:SS No Key Date from when the facility is valid
hotelDetailsRS/hotel/facilities/facility@dateTo Date Format YYYY-MM-DD HH:MM:SS No Key Date untilthe facility is valid
hotelDetailsRS/hotel/facilities/facility@timeFrom Date Format YYYY-MM-DD HH:MM:SS No Key Time fromwherethe facility is valid
hotelDetailsRS/hotel/facilities/facility@timeTo Date Format YYYY-MM-DD HH:MM:SS No Key Time until the facility is valid
hotelDetailsRS/hotel/facilities/facility@indYesOrNo Boolean No Key Indicator if the mandatory facility exists at the hotel or not
hotelDetailsRS/hotel/facilities/facility@amount Float 15 digits (5 can be decimals) No Key Amount of the facility fee
hotelDetailsRS/hotel/facilities/facility@currency String 3 No Key Currency of the facility fee
hotelDetailsRS/hotel/facilities/facility@applicationType String 2 No Key

Application type of the facility fee:

PN – Per Person & Night

PS – Per Person & Stay

UH – Per Unit & Hour

UN – Per Unit & Night

US – Per Unit & Stay

hotelDetailsRS/hotel/facilities/facility/description String 100 No Key Multilanguage description of the hotel facility
hotelDetailsRS/hotel/facilities/facility/description@languageCode String 3 No Key Language in which the facilitily description is shown
hotelDetailsRS/hotel/terminals Array of terminals Occurrences 0..1 No Key List of terminals associated to the hotel and their distance to the hotel.
hotelDetailsRS/hotel/terminals/terminal Terminal element Occurrences 0..* No Key Info of terminal
hotelDetailsRS/hotel/terminals/terminal@terminalCode String 5 Key Terminal code
hotelDetailsRS/hotel/terminals/terminal@terminalType String 1 No key Terminal type code
hotelDetailsRS/hotel/terminals/terminal@distance Float 5 digits (1 of them can be decimal) NoKey Distance in kilometers to the hotel
hotelDetailsRS/hotel/terminals/terminal/name String 100 No Key Multilanguage name of the terminal
hotelDetailsRS/hotel/terminals/terminal/description String 100 No Key Multilanguage description of the terminal type
hotelDetailsRS/hotel/interestPoints/ Array of Points of Interest Occurrences 0..1 No Key List of Points of Interest close to the hotel
hotelDetailsRS/hotel/interestPoints/interestPoint Points of Interest element Occurrences 0..* No Key Info of point of interest close to the hotel
hotelDetailsRS/hotel/interestPoints/interestPoint@facilityCode Integer 3 Key Code of the facility of the interestPoint
hotelDetailsRS/hotel/interestPoints/interestPoint@facilityGroupCode Integer 3 Key Group to which the facility of the interestPoint belongs
hotelDetailsRS/hotel/interestPoints/interestPoint@order Integer 8 Key Order of the interestPoint
hotelDetailsRS/hotel/interestPoints/interestPoint@poiName String 50 No Key Internal description of the point of interest.
hotelDetailsRS/hotel/interestPoints/interestPoint@indFee Boolean No Key Indicator if the point of interest has cost or not at the establishment
hotelDetailsRS/hotel/interestPoints/interestPoint@distance Integer 9 No Key Distance in meters to the point of interest
hotelDetailsRS/hotel/images Array of images Occurrences 0..1 No Key List of hotel pictures
hotelDetailsRS/hotel/images/image Hotel image element Occurrences 0..* No Key Hotel pictures
hotelDetailsRS/hotel/images/image@path String 100 Key Partial path of the Picture URL (See F.A.Q.)
hotelDetailsRS/hotel/images/image@order Integer 5 Key Hotel own room description
hotelDetailsRS/hotel/images/image/type Image type element Occurrences 0..1 No Key Information on the image type
hotelDetailsRS/hotel/images/image/type@code String 3 No Key Image internal type code
hotelDetailsRS/hotel/images/image/type/description String 50 No Key Multilanguage description of the image
hotelDetailsRS/hotel/issues Array of issues Occurrences 0..1 No Key List of incidences, reparations that the hotel is involved in
hotelDetailsRS/hotel/issues/issue Issue element Occurrences 0..* No Key Info of incidences or reparation that the hotel is involved in
hotelDetailsRS/hotel/issues/issue@issueCode String 50 Key Incident code
hotelDetailsRS/hotel/issues/issue@issueType String 25 Key Incident type code
hotelDetailsRS/hotel/issues/issue@alternative Boolean No Key Alternative to the incidence
hotelDetailsRS/hotel/issues/issue@order Integer 8 Key Issue Order in case there is more than one
hotelDetailsRS/hotel/issues/issue@dateFrom Date Format YYYY-MM-DD HH:MM:SS No Key Date from when the issue will start
hotelDetailsRS/hotel/issues/issue@dateTo Date Format YYYY-MM-DD HH:MM:SS No Key Date when the issue will end
hotelDetailsRS/hotel/issues/issue/description String 100 No Key Multilanguage description of the incident

XML schema

<?xml version="1.0" encoding="UTF-8"?>
<hotelDetailsRS xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<auditData 
		processTime="" 
		timestamp="" 
		requestHost="" 
		serverId="" 
		environment="" 
		release=""/>
	<hotel code="" web="" S2C="">
		<name></name>
		<description></description>
		<country code="" isoCode="">
			<description></description>
		</country>
		<destination code="" countryCode="">
			<name></name>
		</destination>
		<zone zoneCode="" name=""/>
		<coordinates longitude="" latitude=""/>
		<category code="">
			<description></description>
		</category>
		<categoryGroup code="">
			<description></description>
		</categoryGroup>
		<chain code=""/>
		<accommodationType code="" typeDescription=""/>
		<boards>
			<board code="">
				<description></description>
			</board>
			<board code="">
				<description></description>
			</board>
		</boards>
		<segments>
			<segment code="">
				<description></description>
			</segment>
		</segments>
		<address></address>
		<postalCode></postalCode>
		<city></city>
		<email></email>
		<phones>
			<phone>
				<phoneNumber></phoneNumber>
				<phoneType></phoneType>
			</phone>
		</phones>
		<rooms>
			<room roomCode="" description="">
				<type code="">
					<description></description>
				</type>
				<characteristic code="">
					<description></description>
				</characteristic>
				<roomFacilities>
					<roomFacility 
						facilityCode="" 
						facilityGroupCode="" 
						indLogic="" 
						indFee="" 
						number="" 
						indYesOrNo="">
						<description></description>
					</roomFacility>
				</roomFacilities>
				<roomStays>
					<roomStay stayType="" order="" description=""/>
				</roomStays>
			</room>
		</rooms>
		<facilities>
			<facility 
				facilityCode="" 
				facilityGroupCode="" 
				order="" 
				indFee="" 
				indYesOrNo="" 
				amount="" 
				currency="" 
				applicationType="" 
				indLogic="" 
				timeFrom="" 
				timeTo="">
				<description></description>
			</facility>
		</facilities>
		<terminals>
			<terminal terminalCode="" terminalType="" distance="">
				<name></name>
				<description></description>
			</terminal>
		</terminals>
		<interestPoints>
			<interestPoint 
				facilityCode="" 
				facilityGroupCode="" 
				order="" 
				poiName="" 
				distance=""/>
		</interestPoints>
		<images>
			<image 
				path="" 
				roomCode="" 
				roomType="" 
				characteristicCode="" 
				order="">
				<type code="">
					<description></description>
				</type>
			</image>          
		</images>
	</hotel>
</hotelDetailsRS>

JSON schema

{
		"auditData": {
			"processTime": "",
			"timestamp": "",
			"requestHost": "",
			"serverId": "",
			"environment": "",
			"release": ""
		},
		"hotel": {
			"code": 0,
			"name": {
				"content": ""
			},
			"description": {
				"content": ""
			},
			"country": {
				"code": "",
				"isoCode": "",
				"description": {
					"content": ""
				}
			},
			"destination": {
				"code": "",
				"name": {
					"content": ""
				},
				"countryCode": ""
			},
			"zone": {
				"zoneCode": 0,
				"name": ""
			},
			"coordinates": {
				"longitude": 00.000000,
				"latitude": 00.000000
			},
			"category": {
				"code": "",
				"description": {
					"content": ""
				}
			},
			"categoryGroup": {
				"code": "",
				"description": {
					"content": ""
				}
			},
			"chain": {
				"code": ""
			},
			"accommodationType": {
				"code": "",
				"typeDescription": ""
			},
			"boards": [{
				"code": "",
				"description": {
					"content": ""
				}
			}],
			"segments": [{
				"code": 34,
				"description": {
					"content": ""
				}
			}],
			"address": {
				"content": ""
			},
			"postalCode": "",
			"city": {
				"content": ""
			},
			"email": "",
			"phones": [{
				"phoneNumber": "",
				"phoneType": ""
			}],
			"rooms": [{
				"roomCode": "",
				"description": "",
				"type": {
					"code": "",
					"description": {
						"content": ""
					}
				},
				"characteristic": {
					"code": "",
					"description": {
						"content": ""
					}
				},
				"roomFacilities": [{
					"facilityCode": 0,
					"facilityGroupCode": 0,
					"description": {
						"content": ""
					},
					"indLogic": false,
					"indFee": false,
					"number": 0,
					"indYesOrNo": false
				}],
				"roomStays": [{
					"stayType": "",
					"order": "",
					"description": ""
				}]
			}],
			"facilities": [{
				"facilityCode": 0,
				"facilityGroupCode": 0,
				"description": {
					"content": ""
				},
				"order": 0,
				"indYesOrNo": false,
				"indLogic": false,
				"indFee": false"amount": 0,
				"currency": "",
				"applicationType": "",
				"timeFrom": "",
				"timeTo": ""
			}],
			"terminals": [{
				"terminalCode": "",
				"terminalType": "",
				"distance": 0,
				"name": {
					"content": ""
				},
				"description": {
					"content": ""
				}
			}],
			"interestPoints": [{
				"facilityCode": 0,
				"facilityGroupCode": 0,
				"order": 0,
				"poiName": "",
				"distance": ""
			}],
			"images": [{
				"type": {
					"code": "",
					"description": {
						"content": ""
					}
				},
				"path": "",
				"roomCode": "",
				"roomType": "",
				"characteristicCode": "",
				"order": 0
			}],
			"web": "",
			"S2C": ""
		}
	}

 

IMPORTANT NOTE:

The hotel images are not returned with the full path. Note you need to add the following path for the different sized images:

http://photos.hotelbeds.com/giata/ + {path} For standard sized images (320px)

http://photos.hotelbeds.com/giata/bigger/ + {path} For HD sized images (800px)

http://photos.hotelbeds.com/giata/medium/ + {path} For medium sized images(117px)

http://photos.hotelbeds.com/giata/small/ + {path} For small sized images/thumbnails (74px)

http://photos.hotelbeds.com/giata/original/ + {path} For images in its original size

Example:
http://photos.hotelbeds.com/giata/00/004200/004200a_hb_ro_006.jpg

Docs Navigation