---
title: "List Org Audit"
method: GET
path: "/v1/orgs/{org_id}/audit"
tags: ["audit"]
---

# List Org Audit

`GET /v1/orgs/{org_id}/audit`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/orgs/{org_id}/audit`
- Auth: none declared

Audit events for this org, newest first. The (target_type, target_id)
pair acts as the per-resource timeline (history of a key/project/member).

## Path parameters

- `org_id` string, required

## Query parameters

- `project_id` string, nullable: filter to one project
- `event` string, nullable: exact event name, e.g. key.created
- `actor_user_uuid` string, nullable: filter by actor user uuid
- `actor_api_key_uuid` string, nullable: filter by actor API-key uuid (service accounts)
- `target_type` string, nullable: resource type; with target_id = per-resource timeline
- `target_id` string, nullable: resource uuid; with target_type = per-resource timeline
- `approval_kind` string, nullable: filter approvals by kind: service | human
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- OrgAuditPage
  - `items` OrgAuditEvent[], required
    - `id` string, required
    - `ts` string, date-time, required
    - `actor_id` string, required
    - `actor_email` string, required
    - `actor_type` string
    - `actor_label` string, nullable
    - `action` string, required
    - `project_id` string, nullable
    - `entity_type` string, required
    - `entity_id` string, nullable, required
    - `before` object, nullable
    - `after` object, nullable
  - `cursor_next` string, nullable, required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

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