Retrieve Room Information

This API provides room types, rate types and rate plans information for a property. The API can return data in JSON formats. The web service responds to HTTP POST requests.

End Point URL

Header

Content-Type: application/json

Parameter

NameData TypeDescriptionExample
Request_Type *Use Keyword “RoomInfo”
NeedPhysicalRoomsINT(2)If you need Room data, then put it “1”.
It is optional
1 / 0
HotelCode *INT(11)Unique Hotel codexxxx
AuthCode *VARCHAR(300)Unique Authentication codexxxxxxxxxx

Request 

 {    
            "RES_Request": {
            "Request_Type": "RoomInfo",
            "NeedPhysicalRooms":1,
            "Authentication": {
                "HotelCode": "xxxx",
                "AuthCode": "xxxxxxxxxxxx"
            }
    }
} 

Response

NameData TypeDescriptionExample
RoomType.IDIntegerUnique RoomType ID1234500000000000001
RoomType.NameStringRoomType NameGarden View Studio Room
RoomType.Rooms.
RoomID
IntegerRoom Unique ID1234500000000000001
RoomType.Rooms.
RoomName
StringRoom Number/Name101
RateType.IDIntegerUnique RateType ID1234500000000000001
RateType.NameStringRateType NameEuropean Plan
RatePlan.RatePlanIDIntegerUnique RatePlan ID1234500000000000001
RatePlan.NameStringRatePlan NameGarden View Studio Room
RatePlan.RoomTypeIDIntegerRoomType ID1234500000000000001
RatePlan.RoomTypeStringRoomType NameGarden View Studio Room
RatePlan.RateTypeIDIntegerRateType ID1234500000000000001
RatePlan.RateTypeStringRateType NameEuropean Plan
Errors.ErrorCodeResponse Error Code301, 404 etc
Errors.ErrorMessageGenerate Response MessageSuccess, Unauthorized Request etc.

Success

 {  "RoomInfo": {
    "RoomTypes": {
      "RoomType": [
        {
          "ID": "1234500000000000001",
          "Name": "Sea View Deluxe Room",
          "Rooms": [
           {
               "RoomID": "1234500000000000001",
               "RoomName": "101"
           },
          {
                "RoomID": "1234500000000000002",
                "RoomName": "102"
          }
        },
        {
          "ID": "1234500000000000002",
          "Name": "Garden View Studio Room",
          "Rooms": [
           {
                 "RoomID": "1234500000000000004",
                 "RoomName": "201"
            },
           {
                "RoomID": "1234500000000000005",
                "RoomName": "202"
           }
        }
      ]
    },
    "RateTypes": {
      "RateType": [
        {
          "ID": "1234500000000000001",
          "Name": "European Plan"
        },
        {
          "ID": "1234500000000000002",
          "Name": "Continental Plan"
        },
        {
          "ID": "1234500000000000005",
          "Name": "Indian Plan"
        }
      ]
    },
    "RatePlans": {
      "RatePlan": [
        {
          "RatePlanID": "1234500000000000001",
          "Name": "Sea View Deluxe Room",
          "RoomTypeID": "1234500000000000001",
          "RoomType": "Sea View Deluxe Room",
          "RateTypeID": "1234500000000000001",
          "RateType": "European Plan",
          "RatePlanType": "INDEPENDENT"
        },
        {
          "RatePlanID": "1234500000000000015",
          "Name": "Garden View Studio Room",
          "RoomTypeID": "1234500000000000002",
          "RoomType": "Garden View Studio Room",
          "RateTypeID": "1234500000000000001",
          "RateType": "European Plan",
          "RatePlanType": "MASTER"
        }
      ]
    }
  },
  "Errors": {
    "ErrorCode": "0",
    "ErrorMessage": "Success"
  }
} 

Error Codes

Error CodeError Name
100Missing required parameters.
500Error occurred during processing
502Request Type is missing
101Hotel Code is missing
102Authentication Code is missing
301Unauthorized Request. Please check hotel code and authentication code
302Unauthorized Request. Integration is not allowed
303Auth Code is inactive.
201Unauthorized request.(Request Type) request is not valid for this hotel code
202Unauthorized request. Hotel code is not active

Click here to Register