---
title: "List ABAC attribute definitions"
slug: "list-abac-attribute-definitions"
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 ABAC attribute definitions

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

- Lists all ABAC attribute definitions.
- Returns a paginated list of attribute definitions (key and allowed values).
- Supports optional filtering by attribute key or value, and pagination via offset and count query parameters.
- Requires the `abac-management` and `manage-abac-admin-room-attributes` permissions.

### Changelog

| Version | Description |
| --- | --- |
| 8.0.0 | Added |
| 8.5.0 | Added the `manage-abac-admin-room-attributes` 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

Number of items per page (default: 25)

keystring

Filter attribute definitions by key (case-insensitive match)

valuesstring

Filter attribute definitions by values (case-insensitive match)

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='a68c63ef-6de8-4d6b-b201-d837cfee38e2'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='a4774faf-a1f2-428f-a677-19d29a0e63dd'>Success</option>
</select>Success

```json
{
  "success": true,
  "attributes": [
    {
      "_id": "69778264070f6083845051e6",
      "key": "departmentNumber",
      "values": [
        "department"
      ]
    },
    {
      "_id": "697ca091070f60838450580d",
      "key": "my_department",
      "values": [
        "eng",
        "sales",
        "hr",
        "it"
      ]
    }
  ],
  "offset": 0,
  "count": 25,
  "total": 5
}
```

Expand Allobject  successboolean    
attributes Array of object   object  _idstring    
keystring    
values Array of string   string    

offsetinteger    
countinteger    
totalinteger    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='a2999e9f-9eeb-4f5c-bee1-8a0ec1a12637'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='afc8a52a-01b6-4a13-810d-7762cfc1f14c'>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='cdb372aa-2c2f-4d51-8509-a14db8bb54ae'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='e1c2a22f-754e-4476-b310-639a9d8a18e3'>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='207242b7-db89-475c-b52b-35a766734ba0'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='e34958d8-c29b-4bb3-abc6-5fccb2a91d1c'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

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

object  successboolean    
errorstring