---
title: "Get all audit events"
method: GET
path: "/audit-events"
tags: ["Audit Events"]
---

# Get all audit events

`GET /audit-events`

Returns the workspace's audit event log with cursor paging. Each event records the actor, target, source, type, and timestamp of a change.

## Query parameters

- `cursor` string, nullable

## Response `200`

- ListAuditEventsResponse
  - `paging` Paging, required
    - `cursor` string, nullable
    - `more` boolean, required
  - `results` AuditEvent[], required
    - `auditEventId` string, required
    - `actor` Actor, required
      - `id` string, required
      - `email` string, nullable
    - `target` string, required
    - `source` string, required
    - `timestamp` string, required
    - `type` string, required

## Changes

- **2025-10-15** `e67d02739533` — 2 info
  - api tag `Audit Events` added
  - api tag `AuditEvents` removed
- **2025-10-07** `7143ea51f307` — 1 breaking, 2 warning, 3 info
  - the `results/items/target` response's property type/format changed from `object`/`` to `string`/`` for status `200`
  - removed the optional property `results/items/target/email` from the response with the `200` status
  - removed the optional property `results/items/target/id` from the response with the `200` status
  - the response property `results/items/actor` became required for the status `200`
  - …2 more

[Change history](https://skmtc.dev/trycourier/apis/courier/changes/audit-events/get.md)

---

[API](https://skmtc.dev/trycourier/apis/courier.md) · [All operations](https://skmtc.dev/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trycourier/courier/revisions/cb8586034158/schema)