OptionSearch
OptionSearch groups rooms, pricing and policy data for a single offer.
Aggregator unique identifier for the option.
Access identifier that supplied the option.
Provider hotel identifier.
Hotel name provided by the supplier.
Provider board code associated with the option.
Descriptive board name.
rateRules object[]
Commercial rules that apply to the option rate.
Type categorising the rule.
Possible values: [RATE_RULES_UNSPECIFIED, RATE_RULES_BALEARIC_RESIDENT, RATE_RULES_CANARY_RESIDENT, RATE_RULES_CUSTOM, RATE_RULES_ESSENTIAL_WORKER, RATE_RULES_HONEYMOON, RATE_RULES_LARGE_FAMILY, RATE_RULES_MOBILE, RATE_RULES_NEGOTIATED, RATE_RULES_CORPORATE, RATE_RULES_OLDER55, RATE_RULES_OLDER60, RATE_RULES_OLDER65, RATE_RULES_PACKAGE, RATE_RULES_PUBLIC_SERVANT, RATE_RULES_UNEMPLOYED, RATE_RULES_WARRANTY]
Free text description supplied by the provider.
rooms object[]
Rooms included in the option.
Identifier that links the room to the requested occupancy.
Provider room identifier.
Room name or description.
roomPrice object
Room total price including taxes or fees.
Indicates whether the price is binding or subject to change.
Recommended selling price.
Net cost injected by the provider.
ISO 4217 currency code for the price amounts.
ratePlan object
Rate plan that governs booking conditions.
Provider rate plan code.
Display name for the rate plan.
promotions object[]
Promotions applied to the room.
Promotion identifier.
Human readable promotion name.
Promotion amount or percentage as provided by the supplier.
Start date for the promotion validity window.
End date for the promotion validity window.
Deprecated: number of units allocated for this room.
price object
Total price for the stay.
Indicates whether the price is binding or subject to change.
Recommended selling price.
Net cost injected by the provider.
ISO 4217 currency code for the price amounts.
Payment type that dictates collection mechanics.
Possible values: [MERCHANT, DIRECT, CARD_BOOKING, CARD_CHECK_IN]
surcharges object[]
Optional surcharges applied to the booking.
Surcharge type identifier.
Human readable description of the surcharge.
Indicates whether the surcharge is mandatory.
Indicates whether the surcharge is included in the displayed price.
price object
Price associated with the surcharge.
Indicates whether the price is binding or subject to change.
Recommended selling price.
Net cost injected by the provider.
ISO 4217 currency code for the price amounts.
cancelPolicy object
Cancellation policy describing penalties and windows.
cancelPenalties object[]
Penalties applicable when cancelling.
Currency used for the penalty value.
Deadline timestamp after which the penalty applies.
Hours before arrival when the penalty becomes effective.
Type of penalty value.
Possible values: [IMPORT, NIGHTS, PERCENT]
Penalty value interpreted according to penaltyType.
Indicates whether the booking is refundable.
remarks object[]
Additional remarks or notes.
Type identifier that categorises the value.
Associated value.
Indicates whether the option originated from cache instead of a live call.
{
"id": "string",
"accessId": "string",
"hotelCode": "string",
"hotelName": "string",
"boardCode": "string",
"boardName": "string",
"rateRules": [
{
"type": "RATE_RULES_UNSPECIFIED",
"description": "string"
}
],
"rooms": [
{
"occupancyRefId": 0,
"code": "string",
"description": "string",
"roomPrice": {
"binding": true,
"suggested": 0,
"net": 0,
"currency": "string"
},
"ratePlan": {
"code": "string",
"name": "string"
},
"promotions": [
{
"code": "string",
"name": "string",
"amount": "string",
"effectiveDate": "2024-07-29T15:51:28.071Z",
"expireDate": "2024-07-29T15:51:28.071Z"
}
]
}
],
"price": {
"binding": true,
"suggested": 0,
"net": 0,
"currency": "string"
},
"paymentType": "MERCHANT",
"surcharges": [
{
"type": "string",
"description": "string",
"mandatory": true,
"included": true,
"price": {
"binding": true,
"suggested": 0,
"net": 0,
"currency": "string"
}
}
],
"cancelPolicy": {
"cancelPenalties": [
{
"currency": "string",
"deadline": "2024-07-29T15:51:28.071Z",
"hoursBefore": 0,
"penaltyType": "IMPORT",
"value": 0
}
],
"refundable": true
},
"remarks": [
{
"type": "string",
"value": "string"
}
],
"fromCache": true
}