CLcloudbeds
booking-room

Get rooms a reservation can be reassigned to

Returns the reservation's current room assignment, the property's room types, and the rates and rooms available for a room type: the reservation's current type when roomTypeId is omitted, or the requested type when it is provided.

get/booking-room/v1/{bookingRoomId}/assignable-rooms

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/booking-room/v1/{bookingRoomId}/assignable-rooms
  • Auth
    OAuth 2
    Authorization code: https://api.cloudbeds.com/auth/oauth/authorize
    Token URL: https://api.cloudbeds.com/auth/oauth/token scopes: read:reservation

Path parameters

bookingRoomIdstring required
Example:713

The reservation's current room assignment.

Query parameters

roomTypeIdstring
Example:713

Scopes rates and rooms to this room type. Omit to use the reservation's current type.

Headers

x-property-idstring required
Example:1,2,3

A numeric, comma-separated string representing the property IDs, sent in the header.

Response

Assignable rooms and supporting data

OR

Example response

{
  "reservation": {
    "bookingRoomId": "123456",
    "checkinDate": "2026-04-04",
    "checkoutDate": "2026-04-06",
    "currentRoomTypeId": "713",
    "currentRoomId": "713-2",
    "currentRateId": "4521",
    "originalRateTotal": {
      "amount": "12439",
      "currencyCode": "USD"
    },
    "adults": 2,
    "confirmationNumber": "1234567-1",
    "roomGroup": "1",
    "guestName": "Jane Doe",
    "detailedRates": [
      {
        "date": "2026-04-04",
        "rate": {
          "amount": "12439",
          "currencyCode": "USD"
        },
        "adults": {
          "amount": "12439",
          "currencyCode": "USD"
        },
        "kids": {
          "amount": "12439",
          "currencyCode": "USD"
        }
      }
    ]
  },
  "roomTypes": [
    {
      "id": "713",
      "name": "Deluxe King Room"
    }
  ],
  "selectedRoomTypeId": "713",
  "rates": [
    {
      "rateId": "4521",
      "rateType": "standard",
      "name": "Deluxe King Room",
      "rateTotal": {
        "amount": "12439",
        "currencyCode": "USD"
      },
      "detailedRates": [
        {
          "date": "2026-04-04",
          "rate": {
            "amount": "12439",
            "currencyCode": "USD"
          },
          "adults": {
            "amount": "12439",
            "currencyCode": "USD"
          },
          "kids": {
            "amount": "12439",
            "currencyCode": "USD"
          }
        }
      ]
    }
  ],
  "rooms": [
    {
      "roomId": "713-2",
      "name": "Room 201",
      "housekeepingStatus": "clean"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.