Rooms

A room within a location.

The room object

Attributes

_id
string

A unique Id for the room.
archived
boolean

Flag indiciating if the room has been archived.
created
string

The date/time the group was created.
features
list of strings

A list of the room's features.
floor
string

The floor the room is located on; -1, 0, 1, 2, 3, 4, 5.
funding_types
list of strings

A list of the funding types the room is available for; private, local_authority, local_authority_top_up, chc, chc_lifestyle, block_bed, dta_spot, property_disregard, deferred_payment, section_117_aftercare.
location
string

The Id of the location the room is in.
modified
string

The date/time the group was modified.
name_no
string

The name/no. of the room.
rates
hash

A hash of room rates, keys are room rate type Ids and values are the rate for the room rate type.
- rates.{room_rate_type_id}
  integer
  
  The rate for the room (in pence).
suitable_for
list of strings

A list of the type of care the room is suitable for; assisted_living, assisted_living_dementia, bariatric_care, independent_living, learning_disability_care, residential, residential_dementia, nursing, nursing_dementia, specialist_care, specialist_care_dementia.
supports_double_occupancy
list of booleans

Flag indicating if the room supports dual occupancy.

The room object

{
    "_id": "69b29b8585f06fda012b2197",
    "archived": false,
    "created": "2026-03-12 10:55:01",
    "features": [
        "69b29b8485f06fda012b20ed",
        "69b29b8485f06fda012b20f5"
    ],
    "floor": "0",
    "funding_types": [
        "private",
        "local_authority",
        "local_authority_top_up",
        "chc",
        "chc_lifestyle",
        "block_bed",
        "dta_spot"
    ],
    "location": "69b29b8485f06fda012b2159",
    "modified": "2026-03-12 10:55:01",
    "name_no": "1",
    "rates": {
        "69b29b8585f06fda012b218b": 113000,
        "69b29b8585f06fda012b218d": 135000,
        "69b29b8585f06fda012b218f": 106000,
        "69b29b8585f06fda012b2191": 162000,
        "69b29b8585f06fda012b2193": 174500,
        "69b29b8585f06fda012b2195": 155500
    },
    "suitable_for": [
        "residential"
    ],
    "supports_double_occupancy": false
}

List all rooms

Return a list of rooms.

Parameters

attributes
optional

default ['_id']

A list of attributes to include for fetched objects.
filters-archived
optional

default no

A filter that allows rooms that are currently archived to be included or excluded.
- unset
- yes
- no
filters-features
optional

A filter that accepts a list of room feature (Group) Ids and filters rooms by the features they have.
filters-floor
optional

A filter that accepts a list of floors filters rooms by the floor they are located on.
- -1
- 0
- 1
- 2
- 3
- 4
- 5
filters-funding_types
optional

A filter that accepts a list of funding types and filters rooms by the funding types they are available for.
- private
- local_authority
- local_authority_top_up
- chc
- chc_lifestyle
- block_bed
- dta_spot
- property_disregard
- deferred_payment
- section_117_aftercare
filters-ids
optional

A filter that accepts a list of Ids and filters the items returned to those with an Id in the list.
filters-location
optional

A filter that accepts a list of location Ids and filters rooms by their location.
filters-modified_after
optional

A filter that accepts a date/time and filters the items returned to those modified after the date/time.
filters-modified_before
optional

A filter that accepts a date/time and filters the items returned to those modified before the date/time.
filters-q
optional

A case insensitive keyword filter applied to the following fields; name_no.
filters-suitable_for
optional

A filter that accepts a list of care types and filters rooms by the types of care they are suitable for.
- assisted_living
- assisted_living_dementia
- bariatric_care
- independent_living
- learning_disability_care
- residential
- residential_dementia
- nursing
- nursing_dementia
- specialist_care
- specialist_care_dementia
page
optional

default 1

The page number to fetch.
per_page
optional

default 10

The number of items to return per page.
sort_by
optional

default _id

A list of fields the returned items can be sorted by. Fields prefixed with minus (-) sign are sorted in descending order.
- _id
- created
- floor
- modified
- name_no

Response

Returns a page of rooms.

var rooms = apiClient.Request(
    HttpMethod.Get,
    "rooms",
    new MultiValueDict()
        .Add("attributes", "name_no")
        .Add("filters-location", locationId)
);

const rooms = await apiClient.request(
    "GET",
    "rooms",
    {
        "params": {
            "attributes": ["name_no"],
            "filters-location": locationId
        }
    }
)

<?php

$rooms = $api_client->request(
    'GET',
    'rooms',
    [
        'attributes'=>['name_no'],
        'filters-location'=>$location_id
    ]
);

rooms = api_client(
    'GET',
    'rooms',
    params={
        'attributes': ['name_no'],
        'filters-location': location_id
    }
)

rooms = api_client.request(
    'GET',
    'rooms',
    params: {
        'attributes' => ['name_no'],
        'filters-location' => location_id
    }
)

Response

{
    "item_count": 35,
    "items": [
        {
            "_id": "69b29b8585f06fda012b2197",
            "name_no": "1"
        },
        {
            "_id": "69b29b8585f06fda012b2199",
            "name_no": "2"
        },
        {
            "_id": "69b29b8585f06fda012b219b",
            "name_no": "3"
        },
        {
            "_id": "69b29b8585f06fda012b219d",
            "name_no": "4"
        },
        {
            "_id": "69b29b8585f06fda012b219f",
            "name_no": "5"
        },
        {
            "_id": "69b29b8585f06fda012b21a1",
            "name_no": "6"
        },
        {
            "_id": "69b29b8585f06fda012b21a3",
            "name_no": "7"
        },
        {
            "_id": "69b29b8585f06fda012b21a5",
            "name_no": "8"
        },
        {
            "_id": "69b29b8585f06fda012b21a7",
            "name_no": "9"
        },
        {
            "_id": "69b29b8585f06fda012b21a9",
            "name_no": "10"
        }
    ],
    "page": 1,
    "page_count": 4,
    "per_page": 10
}

Retrieve a room

Retrieve a room object.

Response

Returns a room object.

var room = apiClient.Request(HttpMethod.Get, $"rooms/{roomId}");

const room = await apiClient.request("GET", `rooms/${roomId}`)

<?php

$room = $api_client->request('GET', 'rooms/' . $room_id);

room = api_client('GET', f'rooms/{room_id}')

room = api_client.request('GET', "rooms/#{room_id}")

Response

{
    "_id": "69b29b8585f06fda012b2197",
    "archived": false,
    "created": "2026-03-12 10:55:01",
    "features": [
        "69b29b8485f06fda012b20ed",
        "69b29b8485f06fda012b20f5"
    ],
    "floor": "0",
    "funding_types": [
        "private",
        "local_authority",
        "local_authority_top_up",
        "chc",
        "chc_lifestyle",
        "block_bed",
        "dta_spot"
    ],
    "location": "69b29b8485f06fda012b2159",
    "modified": "2026-03-12 10:55:01",
    "name_no": "1",
    "rates": {
        "69b29b8585f06fda012b218b": 113000,
        "69b29b8585f06fda012b218d": 135000,
        "69b29b8585f06fda012b218f": 106000,
        "69b29b8585f06fda012b2191": 162000,
        "69b29b8585f06fda012b2193": 174500,
        "69b29b8585f06fda012b2195": 155500
    },
    "suitable_for": [
        "residential"
    ],
    "supports_double_occupancy": false
}