Table of Contents

Cabin Availability

Request a list of available cabins in the selected category with the CruiseCabinAvailRQ/RS message pair. The service will return a list of available cabins from which the traveler will make a selection.

Request Example

<OTA_CruiseCabinAvailRQ xmlns="http://www.opentravel.org/OTA/2003/05" CorrelationID="5ffafab0-8b0e-42b0-9f81-a23e73b2a6e4" Version="1.0">
  <POS>
    [..]
  </POS>
  <GuestCounts>
    <GuestCount Quantity="2"/>
  </GuestCounts>
  <SailingInfo>
    <SelectedSailing VoyageID="CS21711JUNKTN">
      <CruiseLine/>
    </SelectedSailing>
    <SelectedCategory PricedCategoryCode="A"/>
  </SailingInfo>
  <SelectedFare FareCode="BESTPRICE"/>
</OTA_CruiseCabinAvailRQ>

Response Example

Response will contain a list of CabinOption elements with available cabin numbers and details:

<vx:OTA_CruiseCabinAvailRS xmlns:ns3="http://www.versonix.com/ota" 
  xmlns:ns4="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:vx="http://www.opentravel.org/OTA/2003/05" 
  CorrelationID="5ffafab0-8b0e-42b0-9f81-a23e73b2a6e4" 
  MoreIndicator="false" 
  TargetName="SW_OTA_TEST@ORADEV" 
  TimeStamp="2021-08-27T14:10:04.460" 
  Version="1.999">
  <vx:Success/>
  <vx:SailingInfo>
    [..]
  </vx:SailingInfo>
  <vx:SelectedFare FareCode="BESTPRICE"/>
  <vx:CabinOptions>
    <vx:CabinOption CabinCategoryCode="A" CabinCategoryStatusCode="36" CabinNumber="1002" 
          CabinRanking="1" DeckName="Deck #1" DeckNumber="1" DeclineIndicator="false" 
          HeldIndicator="false" MaxOccupancy="2" Status="36">
      <vx:Remark>Cabin description</vx:Remark>
    </vx:CabinOption>
    [..]
    <vx:CabinOption CabinCategoryCode="A" CabinCategoryStatusCode="36" CabinNumber="GTY" 
          CabinRanking="2" DeclineIndicator="false" 
          HeldIndicator="false" MaxOccupancy="2" Status="47">
      <vx:Remark>A GTY</vx:Remark>
    </vx:CabinOption>
  </vx:CabinOptions>
</vx:OTA_CruiseCabinAvailRS>
Note

Not-available cabins are NOT returned.

Response Limits

The number of available cabins returned may be limited:

  • You can request a specific limit using the MaxResponses attribute in your request
  • The API may also have a maximum response limit configured server-side

If you need access to more cabin options, consider making multiple requests with different criteria or contact your integration support team.

GTY (Guarantee) Cabin

By default the response in addition to available cabin numbers will also contain a "GTY" cabin. This is to indicate to the customer or a client application that they can also select Guarantee without a cabin number.

By default this is returned always even if GTY is blocked in Seaware, because the real verification of GTY negatively affects performance.

GTY Verification

GTY (Guarantee) cabins may or may not be available depending on sailing rules and restrictions. The API will indicate GTY availability in the response.

If a GTY cabin is shown as available but cannot be booked, you'll receive an error message explaining why. Common restrictions include:

  • Minimum days before sailing
  • Specific cabin categories excluded
  • Promotional restrictions