Hotel Detail Response

Returns all the details associated to the Hotel.

The response can be in JSON or XML format.

JSON Schema

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

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 200 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

  • PN – Per Person Per Night
  •  PS – Per Person Per Stay
  •  UH – Per Unit Per Hour
  •  UN – Per Unit Per Night
  •  US – Per Unit Per Stay
hotels/facilities/description
hotels/facilities/description/@languageCode String Language in which the facilitily description is shown
hotels/facilities/description/@content String Description of the facility
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

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/rooms/@roomType String 3 No Key Internal Room type code, returned only for Unified clients.
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

  • PN – Per Person Per Night
  •  PS – Per Person Per Stay
  •  UH – Per Unit Per Hour
  •  UN – Per Unit Per Night
  •  US – Per Unit Per Stay
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/@stayPosition Integer 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

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/wildcards/@roomType String 3 No Key Internal Room type code, returned only for Unified clients.
hotels/wildcards/@characteristicCode String 15 Key for Non Unified clients, No Key for Unified clients Characteristic code/s of the room
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 Image internal code
hotels/images/@path String

100

Key Partial path of the Picture URL (See F.AQ.)
hotels/images/@order Integer 5 Key Hotel own room description
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

 

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