Oracle Hospitality Room Rotation API

openapi: 3.2.0
info:
  title: OPERA Cloud Service Room Rotation API
  description: APIs to facilitate Room Rotation functionality in OPERA Cloud. Api provides capability to handle Room Rotation in OPERA Cloud. Room Rotation provides room ownership options for automatic inventory rotation and prioritization for owner rooms assignment and occupancy.<br /><br /> Compatible with OPERA Cloud release 26.2.0.0.<br /><br /><p> This document and all content within is available under the Universal Permissive License v 1.0 (https://oss.oracle.com/licenses/upl). Copyright (c) 2020, 2026 Oracle and/or its affiliates.</p>
  version: 26.2.0.0
  termsOfService: https://www.oracle.com/legal/terms.html
  contact:
    email: hospitality_apis_ww_grp@oracle.com
  license:
    name: UPL
    url: https://opensource.org/licenses/upl
servers:
- url: /rmr/v1
tags:
- name: RoomRotation
  description: The REST APIs allow you to perform all actions related to Room Rotation from configuring point calculations for owner rooms, adjustment options for room prioritization and automatic assignment based on owner room utilization.
paths:
  /hotels/{hotelId}/departureStartDate/{departureStartDate}/departureEndDate/{departureEndDate}/reservationRotationPoints:
    get:
      summary: Get list of reservations and the associated rotations points
      description: This API will allow a user to retrieve list of reservations and the number of rotation points associated with a given reservation for requested hotel, departure start date, departure end date, and room numbers. <p><strong>OperationId:</strong>getReservationRotationPoints</p> <p>This API allows a time span of <strong>30</strong> days.</p>
      operationId: getReservationRotationPoints
      deprecated: true
      parameters:
      - name: hotelId
        in: path
        required: true
        description: Unique Id for the Hotel
        schema:
          type: string
          maxLength: 20
          minLength: 1
      - name: departureStartDate
        in: path
        required: true
        description: Departure Start Date of the reservation to be searched.
        schema:
          type: string
          format: date
      - name: departureEndDate
        in: path
        required: true
        description: Departure End Date of the reservation to be searched.
        schema:
          type: string
          format: date
      - name: roomIds
        in: query
        required: true
        description: List of Room Ids for which to return Reservation Rotation Points.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
      - name: confirmationNumber
        in: query
        required: false
        description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.
        schema:
          type: string
          maxLength: 50
          minLength: 1
      - name: surname
        in: query
        required: false
        description: Family name, last name.
        schema:
          type: string
          maxLength: 40
          minLength: 1
      - name: givenName
        in: query
        required: false
        description: Given name, first name or names
        schema:
          type: string
          maxLength: 40
          minLength: 1
      - name: roomClasses
        in: query
        required: false
        description: List of Room Classes for which to return Room Rotation Points. Multiple values can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: roomTypes
        in: query
        required: false
        description: List of Room Types for which to return Room Rotation Points. Multiple values can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: marketCodes
        in: query
        required: false
        description: List of Market Codes to filter reservations. Multiple values may be provided via repeated query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 40
          maxItems: 4000
      - name: floors
        in: query
        required: false
        description: List of Floors to filter reservations. Multiple values may be provided via repeated query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: limit
        in: query
        required: false
        description: Indicates maximum number of records a Web Service should return.
        schema:
          type: integer
          default: 25
      - name: offset
        in: query
        required: false
        description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.
        schema:
          type: integer
          default: 0
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Response object for fetching Reservation Rotation Points. Based on the criteria, reservations and associated rotation points are returned.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/getReservationRotationPoints'
        '204':
          description: Reservation Rotation Points not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - RoomRotation
  ? /hotels/{hotelId}/departureStartDate/{departureStartDate}/departureEndDate/{departureEndDate}/reservationRotationPoints/searches
  : post:
      summary: Get list of reservations and the associated rotations points
      description: This API will allow a user to retrieve list of reservations and the number of rotation points associated with a given reservation for requested hotel, departure start date, departure end date, and room numbers. <p><strong>OperationId:</strong>getReservationRotationPoints</p> <p>This API allows a time span of <strong>30</strong> days.</p>
      operationId: searchReservationRotationPoints
      parameters:
      - name: hotelId
        in: path
        required: true
        description: Unique Id for the Hotel
        schema:
          type: string
          maxLength: 20
          minLength: 1
      - name: departureStartDate
        in: path
        required: true
        description: Departure Start Date of the reservation to be searched.
        schema:
          type: string
          format: date
      - name: departureEndDate
        in: path
        required: true
        description: Departure End Date of the reservation to be searched.
        schema:
          type: string
          format: date
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Response object for fetching Reservation Rotation Points. Based on the criteria, reservations and associated rotation points are returned.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/getReservationRotationPoints'
        '204':
          description: Reservation Rotation Points not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - RoomRotation
      requestBody:
        content:
          application/json;charset=UTF-8:
            schema:
              $ref: '#/components/schemas/searchReservationRotationPointsRequest'
        description: Search filters for reservation rotation points.
        required: true
  /hotels/{hotelId}/reservations/{reservationId}/rooms/{roomId}/reservationRotationPointsDetails:
    get:
      summary: Get list of rotation points details associated with a reservation with adjustment log.
      description: This API will allow a user to retrieve list of rotation points details along with adjustment log for requested hotel, reservation Id and room number. <p><strong>OperationId:</strong>getReservationRotationPointsDetails</p>
      operationId: getReservationRotationPointsDetails
      parameters:
      - name: hotelId
        in: path
        required: true
        description: Unique Id of the Hotel for the reservation.
        schema:
          type: string
          maxLength: 20
          minLength: 1
      - name: reservationId
        in: path
        required: true
        description: Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.
        schema:
          type: string
          maxLength: 2000
          minLength: 1
      - name: roomId
        in: path
        required: true
        description: Room number of the reservation.
        schema:
          type: string
          maxLength: 20
          minLength: 1
      - name: includeAdjustmentLog
        in: query
        required: false
        description: Include adjustment log details in the response.
        schema:
          type: boolean
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Response object for fetching Reservation Rotation Points Details. Rotation points details with adjustment log are returned for the requested hotel, reservation Id and room number.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/getReservationRotationPointsDetails'
        '204':
          description: Reservation Rotation Points Details not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - RoomRotation
    put:
      summary: Update Rotation Points Details associated with a reservation.
      description: This API will allow a user to modify rotation points for the requested hotel, reservation Id and room number. <p><strong>OperationId:</strong>putReservationRotationPointsDetails</p>
      operationId: putReservationRotationPointsDetails
      parameters:
      - name: hotelId
        in: path
        required: true
        description: Unique Id of the Hotel for the reservation.
        schema:
          type: string
          maxLength: 20
          minLength: 1
      - name: reservationId
        in: path
        required: true
        description: Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.
        schema:
          type: string
          maxLength: 2000
          minLength: 1
      - name: roomId
        in: path
        required: true
        description: Room number of the reservation.
        schema:
          type: string
          maxLength: 20
          minLength: 1
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
            Location:
              description: Location of newly created resource
              schema:
                type: string
          description: Response Body.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/status'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - RoomRotation
      requestBody:
        content:
          application/json;charset=UTF-8:
            schema:
              $ref: '#/components/schemas/putReservationRotationPointsDetails'
        description: Collection of Reservation Rotation Points Details
        required: true
  /hotels/{hotelId}/roomRotationPoints:
    get:
      summary: Get Room Rotation Points
      description: Use this API to fetch the individual units' rotation points.<p><strong>OperationId:</strong>getRoomRotationPoints</p> <p>The maximum allowable limit for this API is <strong>100</strong>.</p>
      operationId: getRoomRotationPoints
      parameters:
      - name: hotelId
        in: path
        required: true
        description: Unique Id for the Hotel
        schema:
          type: string
          maxLength: 20
          minLength: 1
      - name: roomRotationPointsDate
        in: query
        required: true
        description: The date for which the Room Rotation Points are being requested
        schema:
          type: string
          format: date
      - name: limit
        in: query
        required: false
        description: Indicates maximum number of records the API should return.
        schema:
          type: integer
          default: 25
      - name: offset
        in: query
        required: false
        description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.
        schema:
          type: integer
          default: 0
      - name: roomClasses
        in: query
        required: false
        description: List of Room Classes for which to return Room Rotation Points. Multiple values can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: roomTypes
        in: query
        required: false
        description: List of Room Types for which to return Room Rotation Points. Multiple values can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: roomIds
        in: query
        required: false
        description: List of Room Ids for which to return Room Rotation Points. Multiple values can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Response object for fetching Room Rotation Points. Based on the criteria, Room Rotation Points information is returned
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/getRoomRotationPoints'
        '204':
          description: Room Rotation Points not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - RoomRotation
    put:
      summary: Update Rotation Points by Room Numbers
      description: Use this operation to update balance forward and adjusted points of individual rooms. <p><strong>OperationId:</strong>putRoomRotationPoints</p>
      operationId: putRoomRotationPoints
      parameters:
      - name: hotelId
        in: path
        required: true
        description: Unique Id for the Hotel
        schema:
          type: string
          maxLength: 20
          minLength: 1
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
            Location:
              description: Location of newly created resource
              schema:
                type: string
          description: Response Body.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/status'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - RoomRotation
      requestBody:
        content:
          application/json;charset=UTF-8:
            schema:
              $ref: '#/components/schemas/roomRotationPointsAdjustment'
        description: Request details containing room, balance forward and adjusted points to update.
        required: true
  /profiles/{profileId}/roomOwnerships:
    get:
      summary: Get Profile Room Owners Details
      description: Use this API to fetch profile Rooms with Room Ownership or Owner Referral records associated. <p><strong>OperationId:</strong>getRoomOwnerships</p>
      operationId: getRoomOwnerships
      parameters:
      - name: profileId
        in: path
        required: true
        description: Unique ID of profile.
        schema:
          type: string
          maxLength: 2000
          minLength: 1
      - name: hotelIds
        in: query
        required: false
        description: Unique Id(s) for the Hotel(s). Multiple Hotels can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: startDate
        in: query
        required: false
        description: The starting value of the date range.
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        description: The ending value of the date range.
        schema:
          type: string
          format: date
      - name: includeReferral
        in: query
        required: false
        description: Include Owner Referral in response flag.
        schema:
          type: boolean
          default: true
      - name: includeAvailableRoomsOnly
        in: query
        required: false
        description: Flag indicating if only rooms available for booking during the date range specified should be included in response.
        schema:
          type: boolean
          default: false
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Response object for Rooms with Room Ownership or Owner Referral records. Based on the criteria, associated Owner Rooms are returned.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/associatedRoomOwnershipListDetails'
        '204':
          description: Associated Room Ownership not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - RoomRotation
  /roomOwners:
    get:
      summary: Get Room Owners Details
      description: Get Room Ownership details for specific room(s) or owners. Hotel Id(s) and at least one other search criteria is required. <p><strong>OperationId:</strong>getRoomOwners</p>
      operationId: getRoomOwners
      deprecated: true
      parameters:
      - name: hotelIds
        in: query
        required: true
        description: Unique Id(s) for the Hotel(s) queried.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 5
          minItems: 1
      - name: surname
        in: query
        required: false
        description: Family name, last name.
        schema:
          type: string
          maxLength: 40
          minLength: 1
      - name: givenName
        in: query
        required: false
        description: Given name, first name or names
        schema:
          type: string
          maxLength: 40
          minLength: 1
      - name: startDateFrom
        in: query
        required: false
        description: The starting value of the start date range.
        schema:
          type: string
          format: date
      - name: startDateTo
        in: query
        required: false
        description: The ending value of the start date range.
        schema:
          type: string
          format: date
      - name: endDateFrom
        in: query
        required: false
        description: The starting value of the end date range.
        schema:
          type: string
          format: date
      - name: endDateTo
        in: query
        required: false
        description: The ending value of the end date range.
        schema:
          type: string
          format: date
      - name: roomClasses
        in: query
        required: false
        description: List of Room Classes for which to return Room Owners. Multiple values can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: roomTypes
        in: query
        required: false
        description: List of Room Types for which to return Room Owners. Multiple values can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: roomIds
        in: query
        required: false
        description: List of Room Ids for which to return Room Owners. Multiple values can be entered by adding multiple query parameters.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 20
          maxItems: 4000
      - name: contractNumber
        in: query
        required: false
        description: Contract Number of the Ownership Record.
        schema:
          type: string
          maxLength: 50
          minLength: 1
      - name: includeInactive
        in: query
        required: false
        description: Indicates whether to return inactive records. Records are considered inactive when the end date of the ownership record is prior to the current property business date.
        schema:
          type: boolean
      - name: limit
        in: query
        required: false
        description: Indicates maximum number of records the API should return.
        schema:
          type: integer
          default: 25
          maximum: 200
      - name: offset
        in: query
        required: false
        description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.
        schema:
          type: integer
          default: 0
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Response object for List of Room Owners. Based on the criteria, associated List of Room Owners are returned.
          content:
            application/json;charset=UTF-8:
              sche

# --- truncated at 32 KB (71 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-roomrotation-api-openapi.yml