The API provides a room rates data for a specific date range, room type and rate type for a property. The API can return data in XML formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | VARCHAR(250) | Use Keyword “Rate” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
| FromDate * | DATE | To send a from date | 2020-07-05 |
| ToDate * | DATE | To send a to date | 2020-07-07 |
Request
<RES_Request> <Request_Type>Rate</Request_Type> <Authentication> <HotelCode>xxxx</HotelCode> <AuthCode>xxxxxxxxxx</AuthCode> </Authentication> <FromDate>2020-03-05</FromDate> <ToDate>2020-03-18</ToDate> </RES_Request>
Response
| Name | Data Type | Description | Example |
| RoomInfo.Source.RoomTypes. RoomType.RoomTypeID | INT(11) | Room Type Id | 1234500000000000001 |
| RoomInfo.Source.RoomTypes. RoomType.RateTypeID | INT(11) | Rate Plan Id | 1234500000000000013 |
| RoomInfo.Source.RoomTypes. RoomType.FromDate | DATETIME | From date | 2020-05-01 |
| RoomInfo.Source.RoomTypes. RoomType.ToDate | DATETIME | To date | 2020-05-10 |
| RoomInfo.Source.RoomTypes. RoomType.RoomRate.Base | Decimal(11,4) | Base Rate | 2500.0000 |
| RoomInfo.Source.RoomTypes. RoomType.RoomRate.ExtraAdult | Decimal(11,4) | Extra Adult Rate | 500.0000 |
| RoomInfo.Source.RoomTypes. RoomType.RoomRate.ExtraChild | Decimal(11,4) | Extra Child Rate | 200.0000 |
| Errors.ErrorCode | – | Response Error Code | 104, 404 etc |
| Errors.ErrorMessage | – | Generate Response Message | Unauthorized Request. etc |
Success
<?xml version="1.0" encoding="UTF-8"?><RES_Response> <RoomInfo> <Source name="PMS"> <RoomTypes> <RateType> <RoomTypeID>1234500000000000001</RoomTypeID> <RateTypeID>1234500000000000013</RateTypeID> <FromDate>2020-03-14</FromDate> <ToDate>2020-03-18</ToDate> <RoomRate> <Base>2500.0000</Base> <ExtraAdult>500.0000</ExtraAdult> <ExtraChild>200.0000</ExtraChild> </RoomRate> </RateType> </RoomTypes> </Source> <Source name="Hotel Hilton - Web"> <RoomTypes> <RateType> <RoomTypeID>1234500000000000001</RoomTypeID> <RateTypeID>1234500000000000001</RateTypeID> <FromDate>2020-03-14</FromDate> <ToDate>2020-03-15</ToDate> <RoomRate> <Base>750.0000</Base> <ExtraAdult>350.0000</ExtraAdult> <ExtraChild>50.0000</ExtraChild> </RoomRate> </RateType> </RoomTypes> </Source> </RoomInfo> </RES_Response>
Error Codes
| Error Code | Error Name |
| 114 | Missing from date in some request |
| 115 | Missing to date in some request |
| 117 | From Date is not valid date |
| 118 | To Date is not valid date |
| 119 | Please check From and To date. To Date should be greater than From Date |
| 113 | Missing roomtype id in some request |
| 400 | Invalid Request Format |
| 302 | Authentication failed |
| 303 | Auth Code is inactive. |
| 301 | Unauthorized request. Request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 111 | Invalid Request |