Skip to main content

BookRq

Represents a hotel booking request.

Properties

NameTypeDescription
BookCriteriaBookCriteriaThe booking criteria for the hotel reservation.
BookCriteria/CheckInStringThe check-in date for the operation, represented as a string in ISO 8601 format (YYYY-MM-DD).
BookCriteria/CheckOutStringThe check-out date for the operation, represented as a string in ISO 8601 format (YYYY-MM-DD).
BookCriteria/CheckInAsDateTimeStringThe check-in date parsed as a DateTime object.
BookCriteria/
CheckOutAsDateTime
StringThe check-out date parsed as a DateTime object.
BookCriteria/TotalNightsIntegerThe total number of nights for the stay, calculated as the difference between check-in and check-out dates.
BookCriteria/LanguageStringThe language code for the operation, represented as a 2-character ISO 639-1 code (e.g., "en", "es").
BookCriteria/CurrencyCurrencyThe preferred currency for the operation, defined as an optional Currency value.
BookCriteria/NationalityStringThe nationality code of the client, represented as a 2-character ISO 3166-1 alpha-2 country code (e.g., "US", "FR").
BookCriteria/AccommodationAccommodationRQAccommodation details for the Quote request, such as the hotel or rental being evaluated.
BookCriteria/Accommodation/
Type
AccommodationTypeSpecifies the type of accommodation being requested, such as Hotel or Rental.
BookCriteria/Accommodation/
Code
StringRepresents a unique code identifying the accommodation in the request.
BookCriteria/BoardCodeStringGets the board code for the booking.
BookCriteria/OccupanciesArray<BookOccupancy>Gets the occupancies for the booking.
BookCriteria/Occupancies/
OccupancyId
IntegerThe unique identifier for the occupancy.
BookCriteria/Occupancies/PaxesArray<BookPaxInput>The collection of passenger inputs (paxes) for the occupancy.
BookCriteria/Occupancies/Paxes/
Age
IntegerThe age of the passenger.
BookCriteria/Occupancies/Paxes/
Name
StringThe first name of the passenger.
BookCriteria/Occupancies/Paxes/
SurName
StringThe surname (last name) of the passenger.
BookCriteria/Occupancies/Paxes/
PersonalTitleType
PersonalTitleTypeThe personal title type of the passenger.
BookCriteria/MarketStringGets or sets the market for the booking.
BookCriteria/RoomsArray<Room>Gets the rooms for the booking.
BookCriteria/Rooms/
OccupancyRefId
IntegerNumeric ID linking this room to its occupancy data in the Occupancy.
BookCriteria/Rooms/CodeStringUnique code assigned to this room.
BookCriteria/Rooms/DescriptionStringDescription of the room's features or characteristics.
BookCriteria/Rooms/RoomPriceRoomPricePricing information for the room, including total price and currency details.
BookCriteria/Rooms/RoomPrice/
Price
PriceThe total price of the room.
BookCriteria/Rooms/RoomPrice/
Price/Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
BookCriteria/Rooms/RoomPrice/
Price/Binding
BooleanIndicates whether the price is binding.
BookCriteria/Rooms/RoomPrice/
Price/Net
DoubleThe net price paid by the Buyer to the Seller.
BookCriteria/Rooms/RoomPrice/
Price/Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
BookCriteria/Rooms/RoomPrice/
Price/NetSpecified
BooleanIndicates whether the net price is explicitly specified.
BookCriteria/Rooms/RoomPrice/
Price/MinimumSellingPrice
DoubleThe minimum selling price.
BookCriteria/Rooms/RoomPrice/
PriceBreakdown
Array<PriceBreakdown>Breakdown of the room price over specific periods, such as daily rates.
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/Price
PriceThe price for each day of the room during the specified period.
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/Price/Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/Price/Binding
BooleanIndicates whether the price is binding.
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/Price/Net
DoubleThe net price paid by the Buyer to the Seller.
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/Price/Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/Price/
NetSpecified
BooleanIndicates whether the net price is explicitly specified.
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/Price/
MinimumSellingPrice
DoubleThe minimum selling price.
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/Start
IntegerThe starting day of the pricing period (inclusive).
BookCriteria/Rooms/RoomPrice/
PriceBreakdown/End
IntegerThe ending day of the pricing period (inclusive).
BookCriteria/Rooms/RefundableBooleanIndicates if the room is refundable based on the cancellation policy.
BookCriteria/Rooms/
RefundableSpecified
BooleanIndicates whether the refundable status has been explicitly specified.
BookCriteria/Rooms/
LegacyRoomId
StringLegacy identifier for internal tracking. Automatically generated using OccupancyRefId and Code.
BookCriteria/Rooms/UnitsIntegerNumber of units available for this room type.
BookCriteria/Rooms/RatePlanRatePlanRate plan associated with this room.
BookCriteria/Rooms/RatePlan/
Code
StringThe unique code for the rate plan.
BookCriteria/Rooms/RatePlan/
Name
StringThe name of the rate plan.
BookCriteria/Rooms/PromotionsArray<Promotion>Promotions or discounts applicable to this room.
BookCriteria/Rooms/Promotions/
Code
StringThe unique code identifying the promotion.
BookCriteria/Rooms/Promotions/
Name
StringThe name of the promotion.
BookCriteria/Rooms/RemarksArray<Remark>Additional remarks or notes about this room.
BookCriteria/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.
BookCriteria/Rooms/Remarks/
Text
StringThe text content of the remark, providing details or additional notes.This can include supplier-specific instructions, conditions, or general information.
BookCriteria/Rooms/SurchargesArray<Surcharge>Additional surcharges applied to this room.
BookCriteria/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.
BookCriteria/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.
BookCriteria/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".
BookCriteria/Rooms/Surcharges/
Price
PriceRepresents the price of this surcharge, including the amount and currency. See Price for details about the price structure.
BookCriteria/Rooms/Surcharges/
Price/Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
BookCriteria/Rooms/Surcharges/
Price/Binding
BooleanIndicates whether the price is binding.
BookCriteria/Rooms/Surcharges/
Price/Net
DoubleThe net price paid by the Buyer to the Seller.
BookCriteria/Rooms/Surcharges/
Price/Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
BookCriteria/Rooms/Surcharges/
Price/NetSpecified
BooleanIndicates whether the net price is explicitly specified.
BookCriteria/Rooms/Surcharges/
Price/MinimumSellingPrice
DoubleThe minimum selling price.
BookCriteria/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.
BookCriteria/Rooms/
CancelPolicy
CancelPolicyCancellation policy specific to this room.
BookCriteria/Rooms/
CancelPolicy/Refundable
BooleanIndicates whether the booking is refundable.
BookCriteria/Rooms/
CancelPolicy/CancelPenalties
Array<CancelPenalty>A collection of penalties that apply if the booking is canceled.
BookCriteria/Rooms/
CancelPolicy/CancelPenalties/
HoursBefore
IntegerIndicates the number of hours before the check-in date when the penalty becomes applicable.
BookCriteria/Rooms/
CancelPolicy/CancelPenalties/
PenaltyType
PenaltyTypeSpecifies the type of penalty enforced upon cancellation.
BookCriteria/Rooms/
CancelPolicy/CancelPenalties/
Currency
CurrencySpecifies the currency in which the penalty value is expressed.
BookCriteria/Rooms/
CancelPolicy/CancelPenalties/
Value
DoubleIndicates the value of the penalty.
BookCriteria/Rooms/
CancelPolicy/CancelPenalties/
Deadline
StringSpecifies the absolute deadline for the penalty in UTC format.
BookCriteria/Rooms/
CancelPolicy/
CancelPolicyDescription
StringProvides additional details or a textual summary of the cancellation policy.
BookCriteria/Rooms/BedsArray<Bed>List of beds available in the room, including types and configurations.
BookCriteria/Rooms/Beds/TypeStringThe type of the bed.
BookCriteria/Rooms/Beds/
Description
StringA description of the bed.
BookCriteria/Rooms/Beds/CountIntegerThe number of beds of this type in the room.
BookCriteria/Rooms/Beds/SharedBooleanIndicates whether the bed is shared.
BookCriteria/Rooms/AmenitiesArray<Amenity>Amenities included with this room, such as Wi-Fi or parking.
BookCriteria/Rooms/Amenities/
Code
StringA unique code that identifies the amenity.
BookCriteria/Rooms/Amenities/
Type
AmenityTypeThe type of the amenity, defined by AmenityType.
BookCriteria/Rooms/Amenities/
Value
StringThe value associated with the amenity.
BookCriteria/Rooms/Amenities/
Texts
StringAdditional textual information or description for the amenity.
BookCriteria/Rooms/
UnitsSpecified
BooleanIndicates whether the number of units has been explicitly specified.
BookCriteria/Rooms/FeaturesArray<Feature>Features or custom attributes of the room, used for specific integrations.
BookCriteria/Rooms/Features/
Code
StringThe unique code identifying the feature of the room.
BookCriteria/PaymentTypePaymentTypeGets the payment type for the booking.
BookCriteria/RemarksArray<Remark>Gets the remarks for the booking.
BookCriteria/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.
BookCriteria/Remarks/TextStringThe text content of the remark, providing details or additional notes.This can include supplier-specific instructions, conditions, or general information.
BookCriteria/ClientReferenceStringGets the client reference for the booking.
BookCriteria/BookPriceBookPriceGets the book price for the booking.
BookCriteria/BookPrice/PricePriceThe price of the booking.
BookCriteria/BookPrice/Price/
Currency
CurrencyThe currency of the price, represented in ISO 4217 format (e.g., USD, EUR).
BookCriteria/BookPrice/Price/
Binding
BooleanIndicates whether the price is binding.
BookCriteria/BookPrice/Price/
Net
DoubleThe net price paid by the Buyer to the Seller.
BookCriteria/BookPrice/Price/
Gross
DoubleThe gross price, which includes the net price and the Buyer's commission.
BookCriteria/BookPrice/Price/
NetSpecified
BooleanIndicates whether the net price is explicitly specified.
BookCriteria/BookPrice/Price/
MinimumSellingPrice
DoubleThe minimum selling price.
BookCriteria/BookPrice/
DeltaPrice
DeltaPriceThe delta price, representing any allowable price changes or adjustments.
BookCriteria/BookPrice/
DeltaPrice/Amount
DoubleThe fixed amount allowed for the delta price.
BookCriteria/BookPrice/
DeltaPrice/Percentage
DoubleThe percentage allowed for the delta price.
BookCriteria/HolderHolderGets or sets the holder information for the booking.
BookCriteria/Holder/NameStringThe name of the holder.
BookCriteria/Holder/SurNameStringThe surname of the holder.
BookCriteria/Holder/
PersonalTitleType
PersonalTitleTypeThe personal title type of the holder.
BookCriteria/Holder/
ContactInfo
ContactInfoThe contact information of the holder.
BookCriteria/Holder/
ContactInfo/Email
StringThe email address of the passenger.
BookCriteria/Holder/
ContactInfo/Phone
StringThe phone number of the passenger.
BookCriteria/PaymentCardInputCreditCardInputGets the payment card input for the booking.
BookCriteria/PaymentCardInput/
Type
CreditCardTypeThe type of the credit card.
BookCriteria/PaymentCardInput/
Number
StringThe credit card number.
BookCriteria/PaymentCardInput/
Cvc
StringThe Card Verification Code (CVC) of the credit card.
BookCriteria/PaymentCardInput/
Expiration
CreditCardExpirationThe expiration date of the credit card.
BookCriteria/PaymentCardInput/
Expiration/Month
IntegerThe expiration month of the credit card.
BookCriteria/PaymentCardInput/
Expiration/Year
IntegerThe expiration year of the credit card (last two digits).
BookCriteria/PaymentCardInput/
Expiration/YearFull
IntegerGets the full four-digit year of the credit card expiration.
BookCriteria/PaymentCardInput/
IsVcc
BooleanIndicates whether the credit card is a Virtual Credit Card (VCC).
BookCriteria/PaymentCardInput/
Holder
HolderThe holder information of the credit card.
BookCriteria/PaymentCardInput/
Holder/Name
StringThe name of the holder.
BookCriteria/PaymentCardInput/
Holder/SurName
StringThe surname of the holder.
BookCriteria/PaymentCardInput/
Holder/PersonalTitleType
PersonalTitleTypeThe personal title type of the holder.
BookCriteria/PaymentCardInput/
Holder/ContactInfo
ContactInfoThe contact information of the holder.
BookCriteria/PaymentCardInput/
Holder/ContactInfo/Email
StringThe email address of the passenger.
BookCriteria/PaymentCardInput/
Holder/ContactInfo/Phone
StringThe phone number of the passenger.
BookCriteria/PaymentCardInput/
VirtualCreditCard
VirtualCreditCardThe virtual credit card information, if applicable.
BookCriteria/PaymentCardInput/
VirtualCreditCard/
VCCActivationDate
StringGets or sets the activation date of the virtual credit card.
BookCriteria/PaymentCardInput/
VirtualCreditCard/
VCCDeactivationDate
StringGets or sets the deactivation date of the virtual credit card.
BookCriteria/PaymentCardInput/
VirtualCreditCard/
VCCCurrentBalance
DoubleGets or sets the current balance of the virtual credit card.
BookCriteria/PaymentCardInput/
VirtualCreditCard/
VCCCurrencyCode
StringGets or sets the currency code for the virtual credit card balance.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity
ThreeDomainSecurityThe 3-D Secure authentication information for the credit card transaction.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/
ThreeDSVersion
StringGets or sets the version of 3-D Secure protocol used.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/
DSTransactionID
StringGets or sets the Directory Server Transaction ID.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/XID
StringGets or sets the transaction identifier for 3-D Secure.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/ECI
StringGets or sets the Electronic Commerce Indicator.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/CAVV
StringGets or sets the Cardholder Authentication Verification Value.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/PARes
StringGets or sets the Payer Authentication Response.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/
PAResStatus
PAResStatusGets or sets the status of the Payer Authentication Response.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/
CardEnrolledStatus
EnrolledStatusGets or sets the enrollment status of the card in 3-D Secure.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/
MerchantName
StringGets or sets the name of the merchant.
BookCriteria/PaymentCardInput/
ThreeDomainSecurity/
SignatureStatus
SignatureStatusGets or sets the status of the signature in the 3-D Secure process.
BookCriteria/PaymentCardInput/
UrlPayment
UrlPaymentThe URL payment information for the credit card transaction.
BookCriteria/PaymentCardInput/
UrlPayment/Url
StringGets or sets the URL for the payment.
BookCriteria/ParametersArray<Parameter>Gets or sets the additional parameters for the booking.
BookCriteria/Parameters/KeyIntegerIdentifies the parameter with a numeric key.
BookCriteria/Parameters/ValueStringDefines the value associated with the parameter.
BookCriteria/Parameters/
ParameterType
ParameterTypeSpecifies the type of the parameter (ParameterType), whether it is internal or supplier-related.
BookCriteria/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.
BookCriteria/Parameters/RoomIdIntegerAssociates the parameter with a specific room, identified by its ID.
SettingsBookSettingsThe settings for the hotel booking.
Settings/SupplierStringIdentifies the supplier associated with the hotel operation. This is a unique code generated by Travelgate within its system to represent the supplier.
Settings/PlatformStringRepresents the platform on which the hotel operation is performed.Platforms are collections of suppliers, and the platform code is generated by Travelgate to define the operational context.
Settings/ClientStringRepresents the client performing the hotel operation.This is a unique client code assigned by Travelgate to identify the client within its system.
Settings/AccessAccessContains access information required for the operation, including API credentials, endpoints, and other connection details specific to the supplier's integration.
Settings/Access/CodeIntegerThe unique code identifying the access configuration.
Settings/Access/UserStringThe username used for authentication with the supplier.
Settings/Access/PasswordStringThe password used for authentication with the supplier.
Settings/Access/ApiKeyStringThe API key used for authentication or authorization.
Settings/Access/UrlsUrlsThe URLs associated with the access configuration.
Settings/Access/Urls/BookStringThe URL used for booking operations.
Settings/Access/Urls/SearchStringThe URL used for Search operations.
Settings/Access/Urls/QuoteStringThe URL used for Quote operations.
Settings/Access/Urls/GenericStringA generic URL for additional operations.
Settings/Access/ParametersAccessParametersAdditional parameters related to the connection.
Settings/BusinessRulesBusinessRulesSpecifies the business rules to be applied during the operation. These rules define operational constraints and behavior, such as quota limits or prioritization criteria.
Settings/BusinessRules/
OptionsQuota
IntegerThe maximum number of options returned for each board in the search query.
Settings/BusinessRules/
BusinessRuleType
BusinessRulesTypeThe business rule type that determines how Search results are prioritized or filtered.
Settings/TimeoutStringDefines the timeout period for the operation as a string value.This indicates the maximum amount of time to wait for a supplier's response before timing out.The value must be provided in timestamp format (e.g., "00:05:00" for 5 minutes).
Settings/TimeoutAsTimeSpanStringConverts the timeout value from the string representation (Timeout) into a TimeSpan for use in time-based operations.
Settings/
IncludeProviderTransactions
BooleanIndicates whether detailed traces of provider transactions should be included in the operation's response.If enabled, the ProviderAudit field in responses will contain the transaction logs (e.g., requests and responses exchanged with the supplier).
Settings/CommitRequiredBooleanIndicates whether a commit is required for the booking.