---
title: "List ABAC audit events"
slug: "list-abac-audit-events"
updated: 2026-06-01T06:32:04Z
published: 2026-06-01T06:32:04Z
---

> ## 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 audit events

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

- Lists ABAC audit events.
- Returns a paginated audit log of ABAC-related actions (attribute changes, room attribute changes/removals, and ABAC actions), filterable by time range (`start`, `end`) and optional `actor`, with optional sorting.
- Requires the ABAC and Auditing licenses, the `abac-management` and `view-abac-admin-audit` permissions.

### Changelog

| Version | Description |
| --- | --- |
| 8.0.0 | Added |
| 8.5.0 | Added the `view-abac-admin-audit` 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 parametersstartstring

start of time range (defaults to epoch if omitted)

endstring

end of time range (defaults to now if omitted)

actorstring

Filter by actor fields

offsetnumber

Pagination offset (default 0)

countnumber

Page size (default 25)

sortstring

Sorting, typically { "ts": -1 } or { "ts": 1 }

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='5d751732-8697-45bd-baf7-ddd075b04ff1'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='88534af2-cc68-415f-9869-9dc9810502ce'>Success</option>
</select>Success

```json
{
  "success": true,
  "events": [
    {
      "_id": "EVENT_ID",
      "t": "abac.object.attribute.changed",
      "ts": "2026-01-30T12:34:56.789Z",
      "actor": {
        "_id": "USER_ID",
        "username": "admin",
        "name": "Admin"
      },
      "data": {}
    }
  ],
  "offset": 0,
  "count": 25,
  "total": 1
}
```

Expand Allobject  successboolean    
events Array of object   object  _idstring    
tstring    
tsstring    
actorobject  _idstring    
usernamestring    
namestring    

dataobject  

offsetinteger    
countinteger    
totalinteger    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='60996e43-87f6-4ff6-82f7-d7d6a344ca7d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='01258de8-c091-4cc5-8d3d-790fe80f63d4'>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='c2664c5f-2a9e-49e6-9c17-7fd9ef1694c4'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='9bd70c94-4ad3-435b-ab53-6f2925782a43'>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='61bbfabb-3286-45db-a1fa-4cb6cbdb0a7a'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='c77b56a1-8e4c-4e1f-b7b1-61088fb65fe9'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

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

object  successboolean    
errorstring