---
title: "Get Rooms (Realtime)"
slug: "get-rooms-realtime"
updated: 2026-05-14T21:43:18Z
published: 2026-05-14T21:43:18Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Rooms (Realtime)

![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Deprecated.svg)

Get all rooms a user belongs to.

## Payload parameters

| Argument | Example | Required | Description |
| --- | --- | --- | --- |
| `date` | `{ "$date": 1480377601 }` | Required | A timestamp with the latest client update time in order to just send what changed since last call. If it's the first time calling, send a `0` as date. |

## Example call

```json
{
    "msg": "method",
    "method": "rooms/get",
    "id": "42",
    "params": [ { "$date": 1480377601 } ]
}
```

## Example response

The `result` is an object with two fields: `update` and `remove`.

### Remove field

The `remove` field is a collection of room IDs identifying the rooms that were removed from the server.

### Update field

The `update` field is a collection of `room` and its content varies according to the `room type`.

```json
{
    "msg": "result",
    "id": "42",
    "result": {
        "update": [
            ... // rooms
        ],
        "remove": [
            ... // room ids
        ]
    }
}
```