Hotels Response

Returns the hotels matching the requested parameters.

The response can be in JSON or XML format.

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": ""  
       } 
     ] 
   }
 ]
}

Response Parameters

Node/Attribute Type Max Size KEY Description
auditData Element Occurrences 1  No Key  Relevant internal information
auditData/@processTime String Occurrences 1  No Key  Server process time in milliseconds
auditData/@timestamp String Occurrences 1 No Key Date/time when the requests has been processed. Always returned at Spanish time
auditData/@requestHost String Occurrences 1 No Key IP From where the petition was sent to the system
auditData/@serverId String Occurrences 1 No Key Server code or ID(It is for internal use)
auditData/@environment String Occurrences 1 No Key Environment where the request has been sent and processed
auditData/@release String Occurrences 1 No Key Internal Release information
hotels Array of Hotels Occurrences 0..* No Key Top level
hotels/@code Integer 8 Key Internal Hotel Code
hotels/name

Element

Occurrences 0..1 No Key Multilanguage name of the hotel
hotels/name/@languageCode String 3 No Key Language in which the content is returned
hotels/name/@content String 50 No Key Name of the hotel
hotels/@accommodationTypeCode String 8 Key Hotel Type Code it will indicate the type of the hotel (apartment, hotel, home)
hotels/@countryCode String 3 Key Internal Country code
hotels/@destinationCode String 3 Key Internal destination code, where the hotel is located
hotels/@zoneCode Integer 8 Key Code of the Zone within the destination
hotels/coordinates Element Occurrences 0..1 No Key GPS coordinates of the hotel
hotels/coordinates/@latitude Float 25 digits (20 of them can be decimals) No Key Latitude of the hotel
hotels/coordinates/@longitude Float 25 digits (20 of them can be decimals) No Key Longitude of the hotel
hotels/@categoryCode String 5 No Key Hotel rating based on the information provided by the hotel
hotels/@chainCode String 5 No Key Code of the chain that the hotel belongs to
hotels/description Element Occurrences 0..1 No Key Multilanguage description of the hotel
hotels/description/@languageCode String 3 No Key Language in which the content is returned
hotels/description/@content String 4000 No Key Description of the hotel
hotels/address Element Occurrences 0..1 No Key Multilanguage address of the hotel
hotels/address/@languageCode String 3 No Key Language in which the content is returned
hotels/address/@content
String Street: 50
Number: 10
Floor: 3
Stair: 10
No Key Address (composed by Street, Number, Floor and Stair) of the hotel
hotels/@postalCode String 10 No Key Postal code
hotels/city Element Occurrences 0..1 No Key Multilanguage city of the hotel
hotels/city/@languageCode String 3 No Key Language in which the content is returned
hotels/city/@content String 50 No Key City of the hotel
hotels/@email String 100 No Key E-mail address
hotels/@web String 100 No Key Website URL of the hotel or the chain
hotels/@giataCode Double 15 No Key Giata code of the hotel, returned only if the client has agreement with Giata
hotels/@license String 40 No Key License number of the hotel in their country
hotels/phones Array of Phones Occurrences 0..* No Key The list of contact phones of the hotel
hotels/phones/@phoneNumber String 50 Key Phone number
hotels/issues Array of issues Occurrences 0..* No Key List of incidences, reparations that the hotel is involved in
hotels/issues/@issueCode String 50 Key Incident code
hotels/issues/@issueType String 25 Key Incident type code
hotels/issues/@alternative Boolean
No Key  Alternative to the incidence
hotels/issues/@order Integer 8 Key Issue Order in case there is more than one
hotels/issues/@dateFrom Date  Format YYYY-MM-DD HH:MM:SS No Key Date from when the issue will start
hotels/issues/@dateTo Date  Format YYYY-MM-DD HH:MM:SS No Key Date when the issue will end
hotels/terminals Array of terminals  Occurrences 0..* No Key List of terminals associated to the hotel and their distance to the hotel.
hotels/terminals/@terminalCode String 5 Key Terminal code
hotels/terminals/@distance Float 5 digits (1 of them can be decimal) No Key Distance in kilometers to the hotel
hotels/facilities Array of hotel facilities Occurrences 0..* No Key List of facilities, amenities and installations in the hotel.
hotels/facilities/@facilityCode Integer 3 Key Code of the Facility
hotels/facilities/@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotels/facilities/@order Integer 8 Key Order of facility in case there is more than one facility at the hotel
hotels/facilities/@number Integer 9 No Key Numeric value of the facility
hotels/facilities/@indLogic Boolean
No Key Indicator if the facility exists at the hotel or not
hotels/facilities/@indFee Boolean
No Key Indicator if the facility has cost or not at the establishment
hotels/facilities/@distance Integer 9 No Key Distance in meters to the facility
hotels/facilities/@ageFrom Integer 3 No Key Minimum age to access the facility
hotels/facilities/@ageTo Integer 3 No Key Maximum age to access the facility
hotels/facilities/@textValue String 100 No Key Text value of the facility
hotels/facilities/@dateFrom Date  Format YYYY-MM-DD HH:MM:SS No Key Date from when the facility is valid
hotels/facilities/@dateTo Date  Format YYYY-MM-DD HH:MM:SS No Key Date until the facility is valid
hotels/facilities/@timeFrom Date  Format YYYY-MM-DD HH:MM:SS No Key Time from where the facility is valid
hotels/facilities/@timeTo Date  Format YYYY-MM-DD HH:MM:SS No Key Time until the facility is valid
hotels/facilities/@indYesOrNo Boolean
No Key Indicator if the mandatory facility exists at the hotel or not
hotels/facilities/@amount Float 15 digits (5 can be decimals) No Key Amount of the facility fee
hotels/facilities/@currency String 3 No Key Currency of the facility fee
hotels/facilities/@applicationType String 2 No Key Application type of the facility fee
hotels/boardCodes Array of Board Codes Occurrences 0..* String 7 Characters No Key List of the board types offered at the hotel
hotels/segmentCodes Array of segment codes Occurrences 0..* String 3 Characters No Key List of the internal segments to which the hotel belongs (Business hotel, city hotel,...)
hotels/interestPoints Array of Points of Interest Occurrences 0..* No Key List of Points of Interest close to the hotel
hotels/interestPoints/@facilityCode Integer 3 Key Code of the Facility
hotels/interestPoints/@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotels/interestPoints/@order Integer 8 Key Order of facility in case there is more than one facility at the hotel
hotels/interestPoints/@poiName String 50 No Key Internal description of the point of interest.
hotels/interestPoints/@indFee Boolean
No Key Indicator if the facility has cost or not at the establishment
hotels/interestPoints/@distance Integer 9 No Key Distance in meters to the point of interest
hotels/rooms Array of Rooms Occurrences 0..* No Key List of available rooms at the hotel
hotels/rooms/@roomCode String

"Room type code.Characteristics": 18

 

Key Identifier of the room type
hotels/rooms/@roomType String 3 No Key Internal Room type code.
hotels/rooms/@characteristicCode String 15 Key for Non Unified clients, No Key for Unified clients Characteristic code/s of the room
hotels/rooms/roomFacilities Array of room facilities Occurrences 0..* No Key List of facilities, amenities and installations in the room of the hotel.
hotels/rooms/roomFacilities/@facilityCode Integer 3 Key Code of the Facility
hotels/rooms/roomFacilities/@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotels/rooms/roomFacilities/@order Integer 8 Key Order of facility in case there is more than one facility at the hotel
hotels/rooms/roomFacilities/@number Double 9 No Key Numeric value of the facility
hotels/rooms/roomFacilities/@indYesOrNo Boolean
No Key Indicator if the mandatory facility exists at the hotel or not
hotels/rooms/roomFacilities/@indLogic Boolean
No Key Indicator if the facility exists at the hotel or not
hotels/rooms/roomFacilities/@indFee Boolean
No Key Indicator if the facility has cost or not at the establishment
hotels/rooms/roomFacilities/@amount Float 15 digits (5 can be decimals) No Key Amount of the facility fee
hotels/rooms/roomFacilities/@currency String 3 No Key Currency of the facility fee
hotels/rooms/roomFacilities/@applicationType String 2 No Key Application type of the facility fee
hotels/rooms/roomStays Array of Stays Occurrences 0..* No Key List of the different departments in which the room is divided
hotels/rooms/roomStays/@stayType String 10 Key Code of the Department Type
hotels/rooms/roomStays/@description String 50 No Key Description of the type of department
hotels/rooms/roomStays/@order String 3 Key Numeric position of the department within the room
hotels/rooms/roomStays/facilityList Array of Facilities Occurrences 0..* No Key List of facilities, amenities and installations in the department of the room.
hotels/rooms/roomStays/facilityList/@facilityCode Integer 3

Key

Code of the Facility
hotels/rooms/roomStays/facilityList/@facilityGroupCode Integer 3 Key Group to which the facility belongs
hotels/rooms/roomStays/facilityList/@number Integer 9 No Key Numeric value of the facility
hotels/wildcards Array of wild cards Occurrences 0..* No Key List of hotel room descriptions
hotels/wildcards/@roomCode String

"Room type code.Characteristics": 18

 

Key Identifier of the room type
hotels/wildcards/@roomType String 3 No Key Internal Room type code, returned only for Unified clients.
hotels/wildcards/@characteristicCode String 15 No Key Characteristic code/s of the room, ex: Standard, etc. 
hotels/wildcards/hotelRoomDescription
Element Occurrences 0..1 No Key Multilanguage hotel room description
hotels/wildcards/hotelRoomDescription/@languageCode String 3 No Key Language in which the content is returned
hotels/wildcards/hotelRoomDescription/@content String 50 No Key Hotel own room description
hotels/images Array of images Occurrences 0..* No Key List of hotel pictures
hotels/images/@imageTypeCode String 4 Key Specifies where has the picture been taken (you can see the possible values in the response of types/imagetypes operation).
hotels/images/@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.
hotels/images/@order Integer 5 Key Order in which the images are shown in the web page
hotels/images/@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
hotels/images/@roomType String 3 No Key Internal Room type code, returned only for Unified clients.
hotels/images/@characteristicCode String 15 Key for Non Unified clients, No Key for Unified clients Characteristic code/s of the room
@from Integer 8 No Key Record# origin of the response
@to Integer 8 No Key Record# end of the response
@total Integer 8 No Key Total available records

 

IMPORTANT NOTE: 

For hotel images we are not returning the full path. Note that you need to add the following path:

http://photos.hotelbeds.com/giata/    + path returned in the response for standard size images (320px)
http://photos.hotelbeds.com/giata/bigger/   + path returned in the response for HD images (800px)
http://photos.hotelbeds.com/giata/medium/   + path returned in the response for medium size images (117px)
http://photos.hotelbeds.com/giata/small/   + path returned in the response for small size images (74px)
http://photos.hotelbeds.com/giata/original/    + path returned in the response for images in its original size

 

Example: 
http://photos.hotelbeds.com/giata/00/000001/00001a_hb_a_002.jpg 

Docs Navigation