Skip to main content

Hotel

Represents a hotel accommodation in Search responses.

Properties

NameTypeDescription
AccommodationTypeAccommodationTypeGets or initializes the type of accommodation.
AccommodationCodeStringGets the unique code identifying the accommodation.
AccommodationNameStringGets or initializes the name of the accommodation.
BoardsArray<Board>Gets the list of boards available for the hotel.
Boards/BoardCodeStringThe unique code identifying the board.
Boards/NameStringThe name of the board.
Boards/OptionsArray<Option>The collection of options associated with this board.
Boards/Options/FormIdStringInternal field for FormTest. Not serialized. DO NOT USE!
Boards/Options/StatusStatusIndicates the availability status of the option.
Boards/Options/PricePriceThe price details associated with the option, including net, gross and minimum selling price.
Boards/Options/Price/CurrencyCurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
Boards/Options/Price/BindingBooleanIndicates whether the price is binding.
Boards/Options/Price/NetDoubleThe net price paid by the Buyer to the Seller.
Boards/Options/Price/GrossDoubleThe gross price, which includes the net price and the Buyer's commission.
Boards/Options/Price/
NetSpecified
BooleanIndicates whether the net price is explicitly specified.
Boards/Options/Price/
MinimumSellingPrice
DoubleThe minimum selling price.
Boards/Options/PaymentTypesArray<PaymentType>Specifies the accepted payment types for the option.
Boards/Options/RoomsArray<Room>The list of rooms included with the option, including type, description, and price.
Boards/Options/Rooms/
OccupancyRefId
IntegerNumeric ID linking this room to its occupancy data in the Occupancy.
Boards/Options/Rooms/CodeStringUnique code assigned to this room.
Boards/Options/Rooms/
Description
StringDescription of the room's features or characteristics.
Boards/Options/Rooms/RoomPriceRoomPricePricing information for the room, including total price and currency details.
Boards/Options/Rooms/RoomPrice/
Price
PriceThe total price of the room.
Boards/Options/Rooms/RoomPrice/
Price/Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
Boards/Options/Rooms/RoomPrice/
Price/Binding
BooleanIndicates whether the price is binding.
Boards/Options/Rooms/RoomPrice/
Price/Net
DoubleThe net price paid by the Buyer to the Seller.
Boards/Options/Rooms/RoomPrice/
Price/Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
Boards/Options/Rooms/RoomPrice/
Price/NetSpecified
BooleanIndicates whether the net price is explicitly specified.
Boards/Options/Rooms/RoomPrice/
Price/MinimumSellingPrice
DoubleThe minimum selling price.
Boards/Options/Rooms/RoomPrice/
PriceBreakdown
Array<PriceBreakdown>Breakdown of the room price over specific periods, such as daily rates.
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/Price
PriceThe price for each day of the room during the specified period.
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/Price/Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/Price/Binding
BooleanIndicates whether the price is binding.
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/Price/Net
DoubleThe net price paid by the Buyer to the Seller.
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/Price/Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/Price/
NetSpecified
BooleanIndicates whether the net price is explicitly specified.
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/Price/
MinimumSellingPrice
DoubleThe minimum selling price.
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/Start
IntegerThe starting day of the pricing period (inclusive).
Boards/Options/Rooms/RoomPrice/
PriceBreakdown/End
IntegerThe ending day of the pricing period (inclusive).
Boards/Options/Rooms/
Refundable
BooleanIndicates if the room is refundable based on the cancellation policy.
Boards/Options/Rooms/
RefundableSpecified
BooleanIndicates whether the refundable status has been explicitly specified.
Boards/Options/Rooms/
LegacyRoomId
StringLegacy identifier for internal tracking. Automatically generated using OccupancyRefId and Code.
Boards/Options/Rooms/UnitsIntegerNumber of units available for this room type.
Boards/Options/Rooms/RatePlanRatePlanRate plan associated with this room.
Boards/Options/Rooms/RatePlan/
Code
StringThe unique code for the rate plan.
Boards/Options/Rooms/RatePlan/
Name
StringThe name of the rate plan.
Boards/Options/Rooms/
Promotions
Array<Promotion>Promotions or discounts applicable to this room.
Boards/Options/Rooms/
Promotions/Code
StringThe unique code identifying the promotion.
Boards/Options/Rooms/
Promotions/Name
StringThe name of the promotion.
Boards/Options/Rooms/RemarksArray<Remark>Additional remarks or notes about this room.
Boards/Options/Rooms/Remarks/
RemarkType
RemarkTypeThe type of the remark, categorized by RemarkType, specifies its nature or purpose. It may refer to the hotel as a whole, a specific room being booked, services provided by the accommodation, or general remarks not tied to any particular entity.
Boards/Options/Rooms/Remarks/
Text
StringThe text content of the remark, providing details or additional notes.This can include supplier-specific instructions, conditions, or general information.
Boards/Options/Rooms/
Surcharges
Array<Surcharge>Additional surcharges applied to this room.
Boards/Options/Rooms/
Surcharges/ChargeType
ChargeTypeSpecifies whether the surcharge is included in the room rate or must be paid separately at the property. See ChargeType for possible values.
Boards/Options/Rooms/
Surcharges/Mandatory
BooleanIndicates whether this surcharge is mandatory. Mandatory surcharges, such as government taxes, must always be paid, while optional surcharges may depend on the guest's preferences.
Boards/Options/Rooms/
Surcharges/Description
StringProvides a description of the surcharge, giving context about the type of cost it represents.Examples: "Tourist Tax", "Resort Fee", or "Additional Bed Fee".
Boards/Options/Rooms/
Surcharges/Price
PriceRepresents the price of this surcharge, including the amount and currency. See Price for details about the price structure.
Boards/Options/Rooms/
Surcharges/Price/Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
Boards/Options/Rooms/
Surcharges/Price/Binding
BooleanIndicates whether the price is binding.
Boards/Options/Rooms/
Surcharges/Price/Net
DoubleThe net price paid by the Buyer to the Seller.
Boards/Options/Rooms/
Surcharges/Price/Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
Boards/Options/Rooms/
Surcharges/Price/NetSpecified
BooleanIndicates whether the net price is explicitly specified.
Boards/Options/Rooms/
Surcharges/Price/
MinimumSellingPrice
DoubleThe minimum selling price.
Boards/Options/Rooms/
Surcharges/Code
StringAn optional code that uniquely identifies this surcharge for internal or external reference. This can be useful for tracking specific fees or integrating with supplier systems.
Boards/Options/Rooms/
CancelPolicy
CancelPolicyCancellation policy specific to this room.
Boards/Options/Rooms/
CancelPolicy/Refundable
BooleanIndicates whether the booking is refundable.
Boards/Options/Rooms/
CancelPolicy/CancelPenalties
Array<CancelPenalty>A collection of penalties that apply if the booking is canceled.
Boards/Options/Rooms/
CancelPolicy/CancelPenalties/
HoursBefore
IntegerIndicates the number of hours before the check-in date when the penalty becomes applicable.
Boards/Options/Rooms/
CancelPolicy/CancelPenalties/
PenaltyType
PenaltyTypeSpecifies the type of penalty enforced upon cancellation.
Boards/Options/Rooms/
CancelPolicy/CancelPenalties/
Currency
CurrencySpecifies the currency in which the penalty value is expressed.
Boards/Options/Rooms/
CancelPolicy/CancelPenalties/
Value
DoubleIndicates the value of the penalty.
Boards/Options/Rooms/
CancelPolicy/CancelPenalties/
Deadline
StringSpecifies the absolute deadline for the penalty in UTC format.
Boards/Options/Rooms/
CancelPolicy/
CancelPolicyDescription
StringProvides additional details or a textual summary of the cancellation policy.
Boards/Options/Rooms/BedsArray<Bed>List of beds available in the room, including types and configurations.
Boards/Options/Rooms/Beds/TypeStringThe type of the bed.
Boards/Options/Rooms/Beds/
Description
StringA description of the bed.
Boards/Options/Rooms/Beds/
Count
IntegerThe number of beds of this type in the room.
Boards/Options/Rooms/Beds/
Shared
BooleanIndicates whether the bed is shared.
Boards/Options/Rooms/AmenitiesArray<Amenity>Amenities included with this room, such as Wi-Fi or parking.
Boards/Options/Rooms/Amenities/
Code
StringA unique code that identifies the amenity.
Boards/Options/Rooms/Amenities/
Type
AmenityTypeThe type of the amenity, defined by AmenityType.
Boards/Options/Rooms/Amenities/
Value
StringThe value associated with the amenity.
Boards/Options/Rooms/Amenities/
Texts
StringAdditional textual information or description for the amenity.
Boards/Options/Rooms/
UnitsSpecified
BooleanIndicates whether the number of units has been explicitly specified.
Boards/Options/Rooms/FeaturesArray<Feature>Features or custom attributes of the room, used for specific integrations.
Boards/Options/Rooms/Features/
Code
StringThe unique code identifying the feature of the room.
Boards/Options/ParametersArray<Parameter>Parameters for transferring data between operations, such as from Search to Quote or Quote to Book.
Boards/Options/Parameters/KeyIntegerIdentifies the parameter with a numeric key.
Boards/Options/Parameters/
Value
StringDefines the value associated with the parameter.
Boards/Options/Parameters/
ParameterType
ParameterTypeSpecifies the type of the parameter (ParameterType), whether it is internal or supplier-related.
Boards/Options/Parameters/
Immutable
BooleanIndicates whether the parameter remains constant throughout operations (e.g., from Search to Quote and Book). In second searches or quotes, an immutable parameter is used to identify and match the same option.
Boards/Options/Parameters/
RoomId
IntegerAssociates the parameter with a specific room, identified by its ID.
Boards/Options/CancelPolicyOptionCancelPolicyThe cancellation policy associated with the option, detailing penalties and conditions.
Boards/Options/CancelPolicy/
Refundable
BooleanIndicates whether the booking is refundable.
Boards/Options/CancelPolicy/
CancelPenalties
Array<CancelPenalty>A collection of penalties that apply if the booking is canceled.
Boards/Options/CancelPolicy/
CancelPenalties/HoursBefore
IntegerIndicates the number of hours before the check-in date when the penalty becomes applicable.
Boards/Options/CancelPolicy/
CancelPenalties/PenaltyType
PenaltyTypeSpecifies the type of penalty enforced upon cancellation.
Boards/Options/CancelPolicy/
CancelPenalties/Currency
CurrencySpecifies the currency in which the penalty value is expressed.
Boards/Options/CancelPolicy/
CancelPenalties/Value
DoubleIndicates the value of the penalty.
Boards/Options/CancelPolicy/
CancelPenalties/Deadline
StringSpecifies the absolute deadline for the penalty in UTC format.
Boards/Options/CancelPolicy/
CancelPolicyDescription
StringProvides additional details or a textual summary of the cancellation policy.
Boards/Options/CancelPolicy/
RoomCancelPolicyDescriptions
Array<RoomCancelPolicyDescriptions>Gets or sets the list of room-specific cancellation policy descriptions.
Boards/Options/CancelPolicy/
RoomCancelPolicyDescriptions/
OccupancyRefId
IntegerIdentifies the specific occupancy within the booking for which this cancellation policy applies.
Boards/Options/CancelPolicy/
RoomCancelPolicyDescriptions/
Description
StringTextual information detailing the cancellation policy applicable to the room associated with the OccupancyRefId.
Boards/Options/PromotionsArray<Promotion>The promotions applied to the option, such as discounts or special offers.
Boards/Options/Promotions/CodeStringThe unique code identifying the promotion.
Boards/Options/Promotions/NameStringThe name of the promotion.
Boards/Options/RateRulesArray<RateRule2>The rate rules for the option, specifying sales restrictions such as "Senior Discount" or "Resident Rate."
Boards/Options/RateRules/
RateRuleType
RateRuleSelling restrictions applied to the room. These define specific conditions or eligibility requirements that must be met to sell the room. Possible restrictions include:
Boards/Options/RateRules/CodeStringRepresents a unique identifier for the rate rule, typically defined by the supplier.This code is used to reference and distinguish the rule from others.
Boards/Options/RateRules/NameStringProvides a human-readable name or label for the rate rule.This name is typically used in user interfaces or reports to describe the rule.
Boards/Options/RateRules/
Restrictions
Array<Restriction>Defines a collection of additional restrictions that further specify the conditions of the rate rule.Restrictions can include age limits, regional requirements, or special eligibility conditions.
Boards/Options/RateRules/
Restrictions/Code
StringA unique identifier for the restriction.
Boards/Options/RateRules/
Restrictions/Name
StringA descriptive name for the restriction.
Boards/Options/RateRules/
Restrictions/RestrictionType
RestrictionTypeThe type of the restriction, categorizing its purpose or application.
Boards/Options/RemarksArray<Remark>Additional remarks associated with the option, such as special conditions or information.
Boards/Options/Remarks/
RemarkType
RemarkTypeThe type of the remark, categorized by RemarkType, specifies its nature or purpose. It may refer to the hotel as a whole, a specific room being booked, services provided by the accommodation, or general remarks not tied to any particular entity.
Boards/Options/Remarks/TextStringThe text content of the remark, providing details or additional notes.This can include supplier-specific instructions, conditions, or general information.
Boards/Options/SurchargesArray<Surcharge>Surcharges applied to the option, such as mandatory fees or taxes.
Boards/Options/Surcharges/
ChargeType
ChargeTypeSpecifies whether the surcharge is included in the room rate or must be paid separately at the property. See ChargeType for possible values.
Boards/Options/Surcharges/
Mandatory
BooleanIndicates whether this surcharge is mandatory. Mandatory surcharges, such as government taxes, must always be paid, while optional surcharges may depend on the guest's preferences.
Boards/Options/Surcharges/
Description
StringProvides a description of the surcharge, giving context about the type of cost it represents.Examples: "Tourist Tax", "Resort Fee", or "Additional Bed Fee".
Boards/Options/Surcharges/
Price
PriceRepresents the price of this surcharge, including the amount and currency. See Price for details about the price structure.
Boards/Options/Surcharges/
Price/Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
Boards/Options/Surcharges/
Price/Binding
BooleanIndicates whether the price is binding.
Boards/Options/Surcharges/
Price/Net
DoubleThe net price paid by the Buyer to the Seller.
Boards/Options/Surcharges/
Price/Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
Boards/Options/Surcharges/
Price/NetSpecified
BooleanIndicates whether the net price is explicitly specified.
Boards/Options/Surcharges/
Price/MinimumSellingPrice
DoubleThe minimum selling price.
Boards/Options/Surcharges/CodeStringAn optional code that uniquely identifies this surcharge for internal or external reference. This can be useful for tracking specific fees or integrating with supplier systems.
Boards/Options/AmenitiesArray<Amenity>Amenities included with the option, such as "Free Wi-Fi" or "Parking."
Boards/Options/Amenities/CodeStringA unique code that identifies the amenity.
Boards/Options/Amenities/TypeAmenityTypeThe type of the amenity, defined by AmenityType.
Boards/Options/Amenities/ValueStringThe value associated with the amenity.
Boards/Options/Amenities/TextsStringAdditional textual information or description for the amenity.
Boards/Options/SupplementsArray<Supplement>Supplements available with the option, such as activity passes.
Boards/Options/Supplements/
Code
StringThe unique code identifying the supplement.
Boards/Options/Supplements/
Name
StringThe descriptive name of the supplement.
Boards/Options/Supplements/
Description
StringAn optional textual description providing additional details about the supplement.
Boards/Options/Supplements/
Mandatory
BooleanIndicates whether the supplement is mandatory for the booking.
Boards/Options/Supplements/
Price
PriceThe Price associated with the supplement, including details such as currency and net price.
Boards/Options/Supplements/
Price/Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
Boards/Options/Supplements/
Price/Binding
BooleanIndicates whether the price is binding.
Boards/Options/Supplements/
Price/Net
DoubleThe net price paid by the Buyer to the Seller.
Boards/Options/Supplements/
Price/Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
Boards/Options/Supplements/
Price/NetSpecified
BooleanIndicates whether the net price is explicitly specified.
Boards/Options/Supplements/
Price/MinimumSellingPrice
DoubleThe minimum selling price.
Boards/Options/Supplements/
SupplementType
SupplementTypeThe specific SupplementType of the supplement (e.g., board, additional service).
Boards/Options/Supplements/
ChargeType
ChargeTypeDefines how the supplement is charged using ChargeType (e.g., per person, per stay).
Boards/Options/Supplements/
DurationType
DurationTypeSpecifies whether the supplement applies to a specific duration (Open or Range).
Boards/Options/Supplements/
Quantity
IntegerThe quantity of the supplement included in the booking.
Boards/Options/Supplements/
StartDate
StringThe start date for the supplement (if applicable).
Boards/Options/Supplements/
StartDateAsDateTime
StringThe start date as a DateTime object for easier manipulation.
Boards/Options/Supplements/
EndDate
StringThe end date for the supplement (if applicable).
Boards/Options/Supplements/
EndDateAsDateTime
StringThe end date as a DateTime object for easier manipulation.
Boards/Options/Supplements/
Resort
ResortThe associated Resort where the supplement applies.
Boards/Options/Supplements/
Resort/Code
StringUnique code that identifies the resort in the system.
Boards/Options/Supplements/
Resort/Name
StringName of the resort.
Boards/Options/Supplements/
Resort/Description
StringOptional description providing additional details about the resort.
Boards/Options/Supplements/
Unit
UnitTimeTypeSpecifies the unit of time for the supplement (e.g., per day, per stay) using UnitTimeType.
Boards/Options/AddOnsObjectInternal field for passing additional information across layers.
LocationLocationGets the geographical location of the hotel.
Location/CodeStringThe unique code identifying the location.
Location/CountryStringThe ISO 3166-1 alpha-2 country code where the location is situated.
Location/LongitudeDoubleThe longitude coordinate of the location, expressed in decimal degrees.
Location/LatitudeDoubleThe latitude coordinate of the location, expressed in decimal degrees.