---
title: "List rooms with ABAC attributes"
slug: "list-rooms-with-abac-attributes"
updated: 2026-06-08T12:46:40Z
published: 2026-06-08T12:46:40Z
---

> ## 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.

# List rooms with ABAC attributes

Get/api/v1/abac/rooms![Defense](https://raw.githubusercontent.com/RocketChat/Rocket.Chat-Open-API/main/images/Defense.svg)

- Lists rooms with ABAC attributes.
- Returns a paginated list of rooms that have ABAC attributes configured, with optional filtering by room name, attribute key, or attribute value using the `filter` and `filterType` query parameters.
- Requires the `abac-management` and `manage-abac-admin-rooms` permissions.

### Changelog

| Version | Description |
| --- | --- |
| 8.0.0 | Added |
| 8.5.0 | Added the `manage-abac-admin-rooms` granular permission requirement. |

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Query parametersoffsetnumber

Pagination offset (default 0)

countnumber

Page size (default 25)

filterstring

Search text

filterTypestring

One of: all, roomName, attribute, value

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='e4779c53-eac0-41d2-a2c5-e9d72f045d8e'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='50c057a2-7354-46cf-b973-aea7c04fc67b'>Success</option>
</select>Success

```json
{
  "success": true,
  "rooms": [
    {
      "_id": "ROOM_ID",
      "name": "private-room",
      "t": "p",
      "abacAttributes": [
        {
          "key": "my_department",
          "values": [
            "eng",
            "sales"
          ]
        }
      ]
    }
  ],
  "offset": 0,
  "count": 25,
  "total": 1
}
```

Expand Allobject  successboolean    
rooms Array of object   object  _idstring    
namestring    
tstring    
abacAttributes Array of object   object  keystring    
values Array of string   string    

offsetinteger    
countinteger    
totalinteger    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='a332ce70-05b2-47d9-a1d3-e0b04f5c9432'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='fe0f236e-6b67-44bb-b1e2-8ba117b2e572'>Invalid query</option>
</select>Invalid query

```json
{
  "success": false,
  "error": "error-invalid-query-parameters"
}
```

object  successboolean    
errorstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='f1e05771-99d5-4036-8673-7751870f4dfd'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='c37c4483-a199-43a6-a264-425b509ffea9'>Unauthorized login attempt</option>
</select>Unauthorized login attempt

```json
{
  "success": false,
  "error": "error-unauthorized"
}
```

object  successboolean    
errorstring    

403

Forbidden

<select class='api-response-data' aria-label='Media type'><option value='320ed8ee-0d90-460d-9a97-53c33ef6495e'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='d75b79f2-43ca-4c96-9c3a-e21c3c016026'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

```json
{
  "success": false,
  "error": "error-not-authorized"
}
```

object  successboolean    
errorstring