Retrieve Room Inventory

The API provides a room inventory data for a specific date range and room type for a property. The API can return data in XML formats. The web service responds to HTTP POST requests.

End Point URL

Header

Content-Type: application/xml

Parameter

NameData TypeDescriptionExample
Request_Type *VARCHAR(250)Use Keyword “Inventory” 
HotelCode *INT(11)Unique Hotel codeXXXX
AuthCode *VARCHAR(300)Unique Authentication codeXXXXXXXXXXXXXXXXX
FromDate *DATETo send a from date2020-07-05
ToDate *DATETo send a to date2020-07-07

Request 

<RES_Request>   
<Request_Type>Inventory</Request_Type>
   <Authentication>
       <HotelCode>xxxx</HotelCode>
       <AuthCode>xxxxxxxxxx</AuthCode>
   </Authentication>
   <FromDate>2020-03-05</FromDate>
   <ToDate>2020-03-18</ToDate>
</RES_Request>

Response

NameData TypeDescriptionExample
RoomInfo.Source.RoomTypes.
RoomType.RoomTypeID
INT(11)Room Type Id1234500000000000001
RoomInfo.Source.RoomTypes.
RoomType.FromDate
DATETIMEFrom date2020-05-01
RoomInfo.Source.RoomTypes.
RoomType.ToDate
DATETIMETo date2020-05-10
RoomInfo.Source.RoomTypes.
RoomType.Availability
INT(11)No. Of room available4
Errors.ErrorCodeResponse Error Code104, 404 etc
Errors.ErrorMessageGenerate Response MessageUnauthorized Request. etc

Success

<?xml version="1.0" encoding="UTF-8"?><RES_Response>
    <RoomInfo>
        <Source name="Front">
            <RoomTypes>
                <RoomType>
                    <RoomTypeID>1234500000000000001</RoomTypeID>
                    <FromDate>2020-03-11</FromDate>
                    <ToDate>2020-03-16</ToDate>
                    <Availability>1</Availability>
                </RoomType>
                <RoomType>
                    <RoomTypeID>1234500000000000007</RoomTypeID>
                    <FromDate>2020-03-18</FromDate>
                    <ToDate>2020-03-18</ToDate>
                    <Availability>5</Availability>
                </RoomType>
            </RoomTypes>
        </Source>
    </RoomInfo>
</RES_Response>

Error Codes

Error CodeError Name
114Missing from date in some request
115Missing to date in some request
117From Date is not valid date
118To Date is not valid date
119Please check From and To date. To Date should be greater than From Date
113Missing roomtype id in some request
400Invalid Request Format
302Authentication failed
303Auth Code is inactive.
301Unauthorized request. Request is not valid for this hotel code
202Unauthorized request. Hotel code is not active
111Invalid Request

Click here to Register