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

- `created_gte` string, date-time
- `created_lte` string, date-time
- `event_type` integer[]
- `limit` integer
- `page` integer
- `since` string, date-time
- `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

## Changes

- **2026-08-26** `d8eda658fd32` — 1 info
  - added the new optional `query` request parameter `since`
- **2026-08-25** `2ef6e2cdfaef` — 2 info
  - added the new optional `query` request parameter `created_gte`
  - added the new optional `query` request parameter `created_lte`

[Change history](https://skmtc.dev/cubesoftware/apis/cube-api/changes/governance/audit-trail/get.md)

---

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