1. Hotels

Version 4.1 by Giorgi Mdivnishvili on 2024/02/26 15:10

https://restapi.rustaronline.com/v1.01/api/hotels

Method: GET

Parameters to pass: agentid and agentpassword

Sample URL: https://restapi.rustaronline.com/v1.01/api/hotels?agentid=test.test&agentpassword=TestP@ssw0rd

The method returns the list of hotels with the statuses and timestamps of the prices

Return value example:

{
 "Code": "00",
 "Message": "",
 "Timestamp": "2016-06-27T19:20:00.7512185+04:00",
 "Version": 1.01,
 "ResponseID": "b512a117-6745-493d-9fa4-828d79c0df1d",
 "Data": [
    {
     "hotelid": "d6f9299f-5d94-4955-85e7-003e0383023c",
     "hotelname": "Summer Land Motel - Sharjah",
     "pricestatus": "ready",
     "cityid": "f78ac3bc-f040-46d0-8319-2c52083080a6",
     "cityname": "Sharjah",
     "districtid": "7ac1bbc8-59ea-4977-b272-ed8553f94f9b",
     "districtname": "Sharjah",
     "hasalcohol": false,
     "hasfreewifi": true,
     "hasmall": false,
     "hasmetro": false,
     "haspool": true,
     "hotelclass": "***",
     "hoteltype": "City",
     "popular": false,
     "recommended": false,
     "priceupdated": "2016-04-24T11:12:09.66",
     "note": "Check-in time is 14:00 hrs, Check-out time is 12:00 hrs\r\n\r\n\r\nHotel guests can  access the pool and beach of Beach Hotel Sharjah hotel - AED 20.00 ($5.50) for 1 person a day.          \r\nHotel guests can  access the pool and beach of Sharjah Carlton Hotel hotel - AED 20.00 ($5.50) for 1 person a day.          \r\nHotel guests can  access the pool and beach of Golden Beach Motel hotel - AED 15.00 ($4.10) for 1 person a day.          \r\nThe hotel provides a group transfer to Dubai (Naser Square).\r\n\r\n\r\n",
     "imageurl": "https://www.rustaronline.com/images/pages/hotels/thumbnail/F2EB7838-B479-4A81-BE9A-8113E06C70B5.jpg"
    },
    {
     "hotelid": "60d6bb96-a8ba-4c14-908e-7a9227c34bf3",
     "hotelname": "Burj Al Arab",
     "pricestatus": "ready",
     "cityid": "f5185fa3-3f56-44ed-bf6b-80386a33caa2",
     "cityname": "Dubai",
     "districtid": "e6f59e6e-4747-4c14-9b6b-a709cce36c33",
     "districtname": "Jumeirah",
     "hasalcohol": true,
     "hasfreewifi": true,
     "hasmall": false,
     "hasmetro": false,
     "haspool": true,
     "hotelclass": "*****",
     "hoteltype": "Beach",
     "popular": false,
     "recommended": false,
     "priceupdated": "2016-06-19T14:17:39.65",
     "note": null,
"imageurl": ""
    }
  ]
}

hotelid:              GUID of the hotel in the database of Rustar. This GUID will be used to retrieve additional information (like prices) about the hotel

hotelname:        string. Name of the hotel

pricestatus:       string. "ready" or "pending". “ready” means that prices are ready to be downloaded. “pending” means that price registration is under processing and not all prices are available for the hotel. In case of “pending” the prices should be downloaded later when the status is changed to “ready”.

cityid:                GUID of the City where the hotel is located.

cityname:          string. Name of the city

districtid:          GUID of the district, where the hotel is located

districtname:     string. Name of the district

hasalcohol:        Boolean parameter. Describes whether hotel serves alcohol or not

hasfreewifi:       Boolean parameter. Describes whether free wifi is available in the rooms

hasmall:            Boolean parameter. Describes whether there is a shopping mall near the hotel

hasmetro:          Boolean parameter. Describes whether there is a metro station near the hotel

haspool:            Boolean parameter. Describes whether there is swimming pool in the hotel

hotelclass:         string. “*”,”**”,”***”,”****”,”*****” or ”Apartments”. Number of stars or Apartment hotel

hoteltype:          string. "City" or “Beach”. Describes whether this hotel is located in the city or at the beach

popular:            Boolean. Describes if the hotel was popular last 7 days

recommended:   Boolean. True if the hotel is recommended by Rustar

priceupdated:    DateTime of the last price update

note:                  string. Free formed text

imageurl:           string. Optional. Points the URL for the image of the hotel if any.