HOTEL ROOM

This method is used to request room details of a particular hotel based on ‘TraceId’, ‘ResultIndex’ and ‘HotelCode’. RoomDetailsResponse consists of Amenities, Bed Type details, refined cancellation policies and other details of the hotel rooms. It also provides room combination details.

Service URL (REST) to be used:
https://hotel.srdvtest.com/v8/rest/GetHotelRoom
Hotel Room Request
Level Element Format Comments Mandatory
1 EndUserIp String Public IP address of the end user initiating the hotel search request. Used for security, tracking, and compliance purposes. Mandatory
2 ClientId String Unique client identifier assigned to the agency during API registration and onboarding. Mandatory
3 UserName String Username provided to the agency at the time of registration registration Mandatory
4 Password String Password provided to the agency at the time of registration Mandatory
5 TraceId String Trace ID (Trace Id to be echoed back from search response. This can be used to trace particular search/ book at SRDV's end) Mandatory
6 SrdvType String Response type identifier indicating the version or category of data returned by the SRDV system. Mandatory
7 SrdvIndex String Unique identifier for the hotel search result record. Mandatory
8 ResultIndex String Result Index (Index of the hotel for which details are to be fetched) Mandatory
9 HotelCode String Unique hotel code Hotel Code for which details are to be fetched Mandatory
Hotel Room Response
Level Element Format Comments Mandatory
1 GetHotelRoomResult Object Includes all the Information related to the hotel Mandatory
2 Error{} Object Contains error details returned by the API when the request cannot be processed successfully. Mandatory
2.1 ErrorCode Integer Unique error code identifying the type of error encountered during request processing. Mandatory
2.2 ErrorMessage String Human-readable description of the error returned by the API. Mandatory
3 SrdvType String Response type identifier indicating the version or category of data returned by the SRDV system. Mandatory
4 ResultIndex String Unique result index used to identify and reference the selected hotel in subsequent requests. Mandatory
5 SrdvIndex String Unique identifier for the hotel search result record. Mandatory
6 TraceId String Unique identifier assigned to the API request for tracking, debugging, and support purposes. Mandatory
7 IsPolicyPerStay Boolean Represents if the cancellation policy is per-stay or per-room. If true, then the cancellation policy is per stay. Optional
8 IsUnderCancellationAllowed Boolean Represents if under cancellation booking is allowed for agency or not. If true, then the agency can make under cancellation booking otherwise not. Mandatory
9 HotelRoomDetails[] Array Hotel Room Details Mandatory
9.1 CategoryName String Name of the room category or accommodation type Mandatory
9.2 Rooms[] Array Collection of room options available under the selected category Mandatory
9.2.1 ChildCount Integer Number of children accommodated in the room Mandatory
9.2.2 RequireAllPaxDetails Boolean Indicates whether passenger details are required for all guests or only the lead guest. If true, details are needed for all; if false, only for the lead guest, though the HotelPassenger array is still required for all guests. Mandatory
9.2.3 RoomId String Unique identifier assigned to the room Mandatory
9.2.4 RoomStatus String Current availability status of the room Mandatory
9.2.5 RoomIndex Integer Unique room index used for room selection and booking reference Mandatory
9.2.6 RoomTypeCode String Unique code representing the room type Mandatory
9.2.7 RoomTypeName String Name of the room type Mandatory
9.2.8 RoomTypeCategory String Category classification of the room type Mandatory
9.2.9 Description String Detailed description of the room and its features Mandatory
9.2.10 RoomImages[] Array Collection of images associated with the room Mandatory
9.2.10.1 Name String Name or title of the room image Mandatory
9.2.10.2 Image String URL of the room image Mandatory
9.3 RatePlanCode String Rate plan code associated with room Mandatory
9.4 RatePlan String Name of the Rate plan Mandatory
9.5 InfoSource String Shows the format to select possible multiple room combinations to book. (Possible values can be FixedCombination, Open Combination) Mandatory
9.6 SequenceNo String Sequence Number of the Room (Not Applicable for API Customers) Optional
9.7 DayRates[] Array Per day rate breakup of the room Mandatory
9.7.1 Date Date Date for which day rate is applicableFormat: (YYYY-MM-DD) Mandatory
9.7.2 Amount Decimal Per day price of the room Mandatory
9.8 SupplierPrice String Price provided by the hotel supplier before any markup or adjustments Optional
9.9 Price{} Object Contains the complete pricing breakdown and fare details applicable to the selected room. Mandatory
9.9.1 CurrencyCode String ISO currency code in which all room pricing values are returned (e.g., INR, USD, EUR). Mandatory
9.9.2 RoomPrice Decimal Base room rate before applying taxes, fees, discounts, or additional charges. Mandatory
9.9.3 Tax Decimal Tax applicable for the room Optional
9.9.4 ExtraGuestCharge Decimal Extra Guest Charges applicable for the room Optional
9.9.5 ChildCharge Decimal Child Charges applicable for the room Optional
9.9.6 OtherCharges Decimal Other Charges applicable for the room Optional
9.9.7 Discount Decimal Discount applicable for the room (Currently not in use) Optional
9.9.8 PublishedPrice Decimal Published Price of the room (This price would be different only if Room Price is on PUBLISHED. In case of NET, Published Price would be same as Offered Price) Mandatory
9.9.9 PublishedPriceRoundedOff Decimal Published Price (rounded off) of the room(This price is for display purpose only) Mandatory
9.9.10 OfferedPrice Decimal Offered Price of the room Mandatory
9.9.11 OfferedPriceRoundedOff Decimal Offered Price (rounded off) of the room (This price is for display purpose only) Mandatory
9.9.12 AgentCommission Decimal Commission applicable on the Room Prices (Srdv will part this amount if Room Price is on Published) Optional
9.9.13 AgentMarkUp Decimal Agent Mark Up applicable on the Room Price (Agent will earn this amount if Hotel mark up is set from backend) Optional
9.9.14 ServiceTax Decimal Service tax applicable for the room Mandatory
9.9.15 TDS Decimal TDS applicable on Commission Earned (This would be deducted only when commission is parted to the agent) Optional
9.9.16 ServiceCharge Decimal Additional service fee charged for processing the booking. Optional
9.9.17 TotalGSTAmount Decimal Total GST amount applicable to the room booking. Optional
9.9.18 GST{} Object Contains a detailed breakdown of GST components applicable to the booking. Optional
9.9.18.1 CGSTAmount Decimal Central Goods and Services Tax (CGST) amount applicable to the booking. Optional
9.9.18.2 CGSTRate Decimal CGST percentage rate applied to the taxable amount. Optional
9.9.18.3 CessAmount Decimal Cess amount levied in addition to applicable GST charges. Optional
9.9.18.4 CessRate Decimal Percentage rate used to calculate the cess amount. Optional
9.9.18.5 IGSTAmount Decimal Integrated Goods and Services Tax (IGST) amount applicable to the booking. Optional
9.9.18.6 IGSTRate Decimal IGST percentage rate applied to the taxable amount. Optional
9.9.18.7 SGSTAmount Decimal State Goods and Services Tax (SGST) amount applicable to the booking. Optional
9.9.18.8 SGSTRate Decimal SGST percentage rate applied to the taxable amount. Optional
9.9.18.9 TaxableAmount Decimal Total amount on which GST and other applicable taxes are calculated. Optional
9.10 RoomPromotion String Promotional offers, special deals, or benefits associated with the room. Optional
9.11 Amenities[] Array Collection of amenities and facilities available within the room. Optional
9.11.1 Name String Name of the room amenity or facility. Optional
9.11.2 FontAwesome String Font Awesome icon class associated with the amenity for UI display purposes. Optional
9.11.3 IcoFont String IcoFont icon class associated with the amenity for UI display purposes. Optional
9.12 SmokingPreference Enumeration Indicates whether the room allows smoking, non-smoking, or both preferences. Optional
9.13 BedTypes String Specifies the type and configuration of beds available in the room. Optional
9.14 HotelSupplements String Additional hotel-provided services, benefits, or supplements applicable to the booking. Optional
9.15 LastCancellationDate Date Last Cancellation Date (No cancellation charge will be applied up to this date. If the date is less than book date then cancellation charge will be applicable as per policy) Mandatory
9.16 IsPassportMandatory Boolean Indicates whether passport details are required for booking confirmation or check-in. Mandatory
9.17 IsPANMandatory Boolean Indicates whether PAN card details are required for booking confirmation or compliance purposes. Mandatory
9.18 ServicesStatus Boolean Indicates the availability status of hotel services associated with the room booking. Mandatory
9.19 FullRefundAllowed Boolean Indicates whether the booking qualifies for a full refund upon cancellation within the permitted period. Mandatory
9.20 CancellationPolicies[] Array Collection of cancellation rules and penalties applicable to the booking. Mandatory
9.20.1 Charge Decimal Cancellation charge (Contains amount in case of Amount, Percentage value in case of Percentage, No of nights in case of Night) Mandatory
9.20.2 ChargeType Enumeration Cancellation charge type ( CancellationPolicies - ChargeType Amount = 1, Percentage = 2, Nights = 3) Mandatory
9.20.3 Currency String Currency code in which the cancellation charge is specified. Mandatory
9.20.4 FromDate Date Date from which charges will apply Format:(YYYY-MM-DDTHH:MM) Mandatory
9.20.5 ToDate Date Date up to which charges will apply Format:(YYYY-MM-DDTHH:MM) Mandatory
9.20.6 OfferedPrice Decimal Room price applicable during the specified cancellation policy period. Mandatory
10 RoomCombinations Object Contains details of valid room combinations available for booking. Mandatory
10.1 InfoSource String Specifies the source or booking mode used to generate room combination information. Mandatory
10.2 RoomCombination[] Array Collection of available room combinations that can be selected for booking. Mandatory