---
title: "List audit events"
method: GET
path: "/v1/audit-events"
---

# List audit events

`GET /v1/audit-events`

## Request

- Base URL: `https://app.ohmyho.st`
- URL: `https://app.ohmyho.st/v1/audit-events`
- Auth: HTTP bearer

Returns events visible to the authenticated organization in stable descending order.

## Query parameters

- `project_id` string
- `operation_id` string
- `cursor` string
- `limit` integer

## Headers

- `X-Request-Id` string

## Response `200`

One page of visible audit events.

- AuditEventPage
  - `items` AuditEvent[], required
    - `audit_event_id` string, required
    - `project_id` string, required
    - `operation_id` string
    - `event_type` string, required
    - `actor_type` string, required
    - `actor_id` string, required
    - `payload` AuditPayloadSummary, required: A redacted, public summary of an internal audit payload.
      - `summary` string, required
    - `occurred_at` string, date-time, required
  - `next_cursor` string, nullable

## Other responses

- `400`: The request failed.
- `401`: The request failed.
- `403`: The request failed.
- `404`: The resource does not exist or is not visible to the authenticated principal.
- `429`: The request failed.
- `503`: The request failed.

---

[API](https://skmtc.dev/ohmyho/apis/ohmyho-st-api.md) · [All operations](https://skmtc.dev/ohmyho/apis/ohmyho-st-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ohmyho/apis/ohmyho-st-api/revisions/d069888c0017?raw)