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

# Audit Trail Events

`GET /governance/audit-trail`

Generates a list of audit trail events similar to what is seen on the Cube portal. These events include data imports from source systems, any data published to Cube from spreadsheets, and when source system dimensions are re-synced.

## Query parameters

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

## Headers

- `X-Company-ID` string, required

## Response `200`

Audit Trail Events

- PaginatedAuditTrailListItemList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` 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)
