Room Options
Room Options
Resources
/availability (xml)
Methods
- n/a
Summary of changes
Room option details are no longer contained within the associated departure. Instead, room options are now a separate resource that is retrievable via GET /departures/{departureId}/room-options
Several fields have been moved from the departure to room option resource. See the departure removed fields section for a list of fields and their counterparts in the GET /departures/{departureId}/room-options endpoint of the Partner API
See response changes section below for a mapping of those fields to the room options resource
Request query parameter changes
- n/a
Response Changes
| Description | XML Feed | Public API | Partner API | Type |
|---|---|---|---|---|
| Room option ID Unique identifier for each specific rooming option within a departure | n/a | id | id | string |
| Room type Category of rooming option e.g. twin share, triple room | n/a | roomTypeName | type | string |
| Number of available spots Current count of remaining bookable spaces in this room option for the departure and what state they’re in e.g. free sell or on request | availability | availability availableSpots/availableSpotsFreeSell | availability status = FREE_SELL/ON_REQUEST Note: total will always show number of spots remaining on request (where status = ON_REQUEST) and free sell (where status = FREE_SELL) | "availability": [ { "status": "FREE_SELL", "total": 5 }, { "status": "ON_REQUEST", "total": 2 } ] |
| Vehicle Specific transport assigned to this room option if applicable for mobile accommodations. This is mostly prevalent in cruising and sailing trips where the vehicle would be the name of the ship. | n/a | vehicleId/vehicleName | vehicle | "vehicle": { "id": "lorem Ipsum", "name": "lorem ipsum" } |
| Capacity Maximum number of guests that can book this rooming option | n/a | capacity | capacity | integer |
| Does this room always require manual confirmation? Boolean indicator for when a room option will always require approval before confirmation is sent | n/a | onRequestOnly | isOnlyOnRequest | boolean |
| The deadline for when a product will stop being free sell Date after which bookings will require manual approval by an operator | n/a | onRequestDays | freeSellDeadline (converted to date) | datetime |
| Can the room be put on hold? *Boolean indicator for when a room option can be temporarily reserved without immediate payment * | n/a | canPlaceOnHoldDeparture | isOnHoldEligible | boolean |
| Whether single supplement is required Boolean showing if solo travelers must purchase a single supplement for an additional fee for this room type. | compulsorySingleSupplement | singleTravellerCompulsorySingleSupFlag | isSingleSupplementCompulsory | boolean |
| The deadline for when a room option is no longer bookable Final cutoff date after which no new bookings accepted for this room option. | n/a | bookingClosed | bookingDeadline (converted to date) | datetime |
| Price details of the room option Complete pricing information including base rates, supplements, discounts, and currency for this accommodation. | n/a | n/a | See prices table | array of objects |
| Add-ons to the room Optional extras, upgrades, or additional services that can be purchased alongside the room. | singleSupplementPrice[@currency] singleSupplementPrice | n/a | currency basePrice New: product type availability | "addons": [ { "product": { "id": "123456", "name": "TTSN Single Supplement", "type": "SINGLE_SUPPLEMENT" }, "availability": [ { "status": "ON_REQUEST", "total": 3 } ], "pricesPerCurrency": [ { "currency": "AUD", "basePrice": 200 } ] |
Current request (deprecated)
No equivalent legacy endpoint existed. Room type variants were embedded inside the trip/departure payload and could not be queried independently.
Updated request
Room options are now a first-class resource so cabin/room variants for cruising and multi-room trips can be selected and priced individually.
GET https://api.partners.intrepidtravel.cloud/room-options?departureId={departureId}
{
"id": "TTSN251005",
"type": "twinShare",
"availability": [
{
"status": "FREE\_SELL",
"total": 7
},
{
"status": "ON\_REQUEST",
"total": 0
}
],
"vehicle": {},
"capacity": 12,
"isOnlyOnRequest": false,
"freeSellDeadline": "2025-09-14T00:00:00.000Z",
"isOnHoldEligible": true,
"isSingleSupplementCompulsory": false,
"prices": [[](#prices_json_sample)[...](#prices_json_sample)[]](#prices_json_sample),
"addons": [
{
"product": {
"id": "169848",
"name": "TTSN - Single supplement",
"type": "SINGLE\_SUPPLEMENT"
},
"availability": [
{
"status": "ON\_REQUEST",
"total": null
}
],
"pricesPerCurrency": [
{
"currency": "AUD",
"basePrice": 350
},
{
"currency": "NZD",
"basePrice": 375
}
]
}
]
}
]
}
Removed fields
Room options is a new resource introduced in the Partner API and so this section is intentially blank.