---
title: "Audit trail event groups"
method: GET
path: "/governance/audit-trail/groups"
tags: ["Audit Trail"]
---

# Audit trail event groups

`GET /governance/audit-trail/groups`

Returns audit trail entries grouped by publish batch (shared OlapCubeChange.batch_id) or as single-event groups when there is no batch. Pagination counts groups, not individual events. Each event includes `metadata` (raw audit payload) in addition to the standard list row shape.

## Query parameters

- `event_type` integer[]
- `limit` integer
- `page` integer
- `user_id` integer[]

## Headers

- `X-Company-ID` string, required

## Response `200`

Paginated list of event groups

- PaginatedAuditTrailGroupList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` AuditTrailGroup[], required
    - `batch_id` string, nullable, required
    - `created_at` string, date-time, required
    - `events` AuditTrailListItem[], required
      - `model_id` string, required
      - `created_at` string, date-time, required
      - `user` AuditTrailListUser, required — Same shape as legacy marshmallow `UserSchema` with `exclude={'email'}` on audit trail rows.
        - `id` integer, required
        - `first_name` string, required
        - `last_name` string, required
        - `is_staff` boolean, required
        - `created_at` string, date-time, required
      - `message` string, nullable, required
      - `type` string, nullable, required
      - `audit_log_event_type` string, required
      - `friendly_type` string, nullable, required
      - `link` object, required
      - `status` string, nullable, required
      - `num_changes` integer, nullable, required
      - `related_change` AuditTrailRelatedChange, required
        - `id` integer, required
        - `relation` string, required
      - `metadata` unknown, required

---

[API](https://skmtc.net/cubesoftware/apis/cube-api.md) · [All operations](https://skmtc.net/cubesoftware/apis/cube-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cubesoftware/cube-api/revisions/67d9f45bb99b/schema)