Retrieve Room Types

This API provides limited information of roomtypes for a property which can be used for the mapping or display purpose in the external applications. The API can return data in JSON formats. The web service responds to HTTP GET requests.

URI Request

Request parameters are supplied by appending a question mark (?) to the base URI, followed by a sequence of parameter names and values separated by an ampersand (&).

End Point URL

[BaseUrl]booking/reservation_api/listing.php?request_type=[Request_Type]&HotelCode=[Hotel_Code]&APIKey=[API_KEY]&publishtoweb=1;

Header

Parameter

NameData TypeDescriptionExample
[BaseUrl] *Live server URLhttps://live.ipms247.com/
[Request_Type] *Use Keyword “RoomTypeList”
[Hotel_Code] *INT(11)Unique Hotel codeXXXX
[API_KEY] *VARCHAR(300)Unique Authentication codeXXXXXXXXXXXXXXXXX
[LANGUAGE]VARCHAR(20)[Optional] Default is en.
Pass language code. Language codes are available here.
en
publishtowebTINYINT(1)1 – will retrieve all Room Types0 – will retrieve room types which are published to WEBDefault value is 00 OR 1

Request 

https://live.ipms247.com/booking/reservation_api/listing.php?request_type=RoomTypeList&HotelCode=XXX&APIKey=XXX&language=en&publishtoweb=1

Response

NameData TypeDescriptionExample
roomtypeunkidINT(20)Unique Room Type ID123400000000000001
roomtypeVARCHAR(255)Room Type NameDeluxe, Luxury
base_adult_occupancyINT(11)Base adult occupancy in room2
base_child_occupancyINT(11)Base child occupancy in room2
max_adult_occupancyINT(11)Maximum adult occupancy in room4
max_child_occupancyINT(11)Maximum child occupancy in room4

Success

[
{
"roomtypeunkid": "123400000000000001",
"roomtype": "King",
"shortcode": "KNG",
"base_adult_occupancy": "2",
"base_child_occupancy": "2",
"max_adult_occupancy": "4",
"max_child_occupancy": "4"
},
{
"roomtypeunkid": "123400000000000004",
"roomtype": "Deluxe",
"shortcode": "DLX",
"base_adult_occupancy": "5",
"base_child_occupancy": "5",
"max_adult_occupancy": "6",
"max_child_occupancy": "7"
},
{
"roomtypeunkid": "123400000000000006",
"roomtype": "Suite River View",
"shortcode": "SRV",
"base_adult_occupancy": "3",
"base_child_occupancy": "2",
"max_adult_occupancy": "5",
"max_child_occupancy": "3"
}
]

Error Codes

Error CodeError Name
HotelCodeEmptyHotel code is empty.
NORESACCThis request is valid for Reservation Account only. You may not have opted for Reservation Account Or Hotel Code and Authentication are invalid.
UNAUTHREQUnauthorized request. This request is not valid for this hotel code.
getRoomTypeListErrorRoom Type List error
-1No Data found.
APIACCESSDENIEDYour property doesn’t have access to API integration or Key is incorrect. Please contact support for this.
ParametersMissingMissing parameters.

Click here to Register