Skip to content

Get Hotel Details

Note:
Few attributes in below sample response are supplier specific, hence there can be possibility these attributes will not appear in the response. We recommend you to parse these fields as mentioned in the sample responses.

/api/v1/hotel/details
  • This service method is used to request for Hotel static/descriptive information (hotel details) based sessionID, searchKey and hotelKey.
  • Hotel Detail Response consist of the Hotel description, location, hotel images, facilities and other basic details of the hotel.


Hotel Detail Request

Tags Attribute Description
HotelDetailsCriteria (JsonObject)
hotelKey*
(String)
Unique Key for each Hotel. This should be taken from Hotel search response
searchKey*
(String)
Unique Key for the search
culture*
(String)
en

hotel detail request
1
2
3
4
5
{
    "hotelKey": "fb0920a8-70b8-433a-a8e2-a8e32efeae5640HTR00000000",
    "searchKey": "fb0920a8-70b8-433a-a8e2-a8e32efeae56",
    "culture": "en"
}



Hotel Detail Response

Tags Attribute Description
meta meta
(Object)
success
(String)
Response status will be return Ex: "true"
statusCode
(Boolean)
Response statusCode will be return Ex: "1"
statusMessage
(String)
Response statusMessage will be return Ex: "SUCCESS"
actionType
(String)
This attribute will indicate that client request type such as Hotel search , Prov book and Book etc... . This is for information purpose.
conversationId
(String)
conversationId a unique identifier of current conversation .
commonData searchKey*
(String)
This attribute contains a unique search key.
culture*
(String)
String
data hotelKey*
(String)
This attribute contains a unique hotel id.
data name*
(String)
Hotel Name
data description
(String)
Hotel Description
data starRating
(String)
Hotel Star rating
data address
(String)
Hotel Address
data postalCode
(String)
Hotel postal code
data city*
(String)
Hotel city
data country*
(String)
Hotel country
data latitude
(String)
Hotel latitude value
data longitude
(String)
Hotel longitude value
data location
(String)
Hotel location
data locationDesc
(String)
Hotel location description
data map
(String)
Hotel map
data phoneNumber
(String)
Hotel phone number
data email
(String)
Hotel email
data website
(String)
Hotel website url
data checkInTime
(DateTime)
Hotel room check-in Time
data checkOutTime
(DateTime)
Hotel room check-out Time
data childPolicy
(String)
Hotel child policy
data currency
(String)
Selling currency of room price
data userRating
(String)
Hotel user rating
roomFacilities (JsonArray) List of room facilities
roomFacility (JsonObject)
roomFacility type
(String)
Room facility type EG:services
Not released yet
roomFacility name
(String)
Room facility name
roomFacility description
(String)
Room facility description
Not released yet
hotelFacilities (JsonArray) List of room facilities
hotelFacility (JsonObject)
hotelFacility type
(String)
Hotel facility type
hotelFacility name
(String)
Hotel facility name
hotelFacility description
(String)
Hotel facility description
Not released yet
nearbyAreas (JsonArray) List of near by areas
nearbyArea (JsonObject)
nearbyArea name
(JsonObject)
Name of nearby area
nearbyArea distance
(String)
distance from hotel
Not released yet
nearbyArea description
(String)
Description of the nearby area
Not released yet
userReviews (JsonArray) List of User ratings
userReview (JsonObject)
userReview userRating
(String)
User rating
userReview firstName
(String)
User first name
userReview lastName
(String)
User last name
userReview description
(String)
User rating description
images (JsonArray) List of Images
image (JsonObject)
image path
(String)
image url
image order
(Integer)
image order
image type
(String)
image type
image description
(String)
image description

hotel detail response
{
  "meta": {
    "success": true,
    "statusCode": "",
    "statusMessage": "",
    "additionalProperties": [
      {
        "key": "timeStamp",
        "value": "YYYY-MM-DD HH:MM:SST",
        "description": "description"
      },
      {
        "key": "serverKey",
        "value": "Server01",
        "description": "description"
      }
    ],
    "actionType": "",
    "conversationId": "fe22cb8d-67e9-4c29-92af-e44dffdcb9a9"
  },
  "warning": [
    {
      "code": "validation_required",
      "documentationUrl": "api-doc/docs/troubleshoot/api-error-codes/index.html",
      "message": "Check In Time' can't be blank",
      "value": "Check In Time might be changed"
    }
  ],
  "errors": [
    {
      "code": "validation_required",
      "documentationUrl": "api-doc/docs/troubleshoot/api-error-codes/index.html",
      "message": "Field ‘hotelKey’ can't be blank",
      "value": "Field ‘hotelKey’ can't be blank",
      "source": {
        "field": "HotelDetailCriteria",
        "pointer": "/HotelDetailCriteria/hotelKey"
      },
      "title": "Required field",
      "type": "validation_error"
    }
  ],
  "commonData": {
    "searchKey": "260d6c37-ab74-4331-9fdc-a9d42a5b55a6",
    "culture": "en"
  },
  "data": {
    "hotelKey": "fb0920a8-70b8-433a-a8e2-a8e32efeae5640htr00000000",
    "name": "summitHotel",
    "description": "located In The Deira District.",
    "starRating": "4",
    "userRating": "4.0",
    "address": "34BStreet,AlRiggaRoad,Deira,Dubai",
    "postalCode": "64264",
    "city": "",
    "country": "",
    "latitude": "",
    "longitude": "",
    "email": "",
    "website": "",
    "location": "",
    "locationDesc": "locatedInTheDeiraDiom.",
    "map": "google map url",
    "phoneNumber": "2341116",
    "checkInTime": "",
    "checkOutTime": "",
    "childPolicy": "",
    "currency": "",
    "roomFacilities": [
      {
        "type": "services",
        "name": "shower",
        "description": "shower"
      },
      {
        "type": "services",
        "name": "smokingPolicy",
        "description": "smokingPolicy"
      }
    ],
    "hotelFacilities": [
      {
        "type": "services",
        "name": "shower",
        "description": "shower"
      }
    ],
    "nearbyAreas": [
      {
        "name": "miraRoadEast",
        "distance": "",
        "desc": ""
      }
    ],
    "userReviews": [
      {
        "userRating": "5.0",
        "firstName": "bharat",
        "lastName": "chaudhari",
        "desc": "excellentRooms,ServiceAndCooperativeStaffNiceOneExperience"
      },
      {
        "userRating": "2.0",
        "firstName": "sameer",
        "lastName": "khan",
        "desc": ""
      }
    ],
    "images": [
      {
        "path": "https://pp.images.dnatatravel.com/ei/2/3/2/1/9/1/0.jpg",
        "order": "0",
        "type": "path",
        "description": ""
      },
      {
        "path": "https://pp.images.dnatatravel.com/ei/2/3/2/1/9/1/1.jpg",
        "order": "1",
        "type": "path",
        "description": ""
      }
    ],
    "additionalProperties": [
      {
        "key": "key1",
        "value": "value1",
        "description": "description"
      },
      {
        "key": "key1",
        "value": "value1",
        "description": "description"
      }
    ]
  }
}