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 meal plan options (Board) available for the hotel.
Boards/BoardCodeStringThe unique code identifying the meal plan option.
Boards/NameStringThe name of the meal plan option.
Boards/OptionsArray<Option>The collection of options associated with this meal plan.
Boards/Options/FormIdStringInternal field for form test. 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.This specifies the nature or purpose of the remark: Related to the hotel as a whole. Specific to the room being booked. Related to services provided by the accommodation. General remarks not tied to a specific 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.This specifies the nature or purpose of the remark: Related to the hotel as a whole. Specific to the room being booked. Related to services provided by the accommodation. General remarks not tied to a specific 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., meal plan, 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.