---
title: "List audit logs"
method: GET
path: "/v1/governance/audit-logs"
tags: ["Governance"]
---

# List audit logs

`GET /v1/governance/audit-logs`

Use this endpoint to retrieve all audit log entries. You can filter the results by actor, date range, action type, and entity type. The response uses cursor-based pagination.

## Query parameters

- `actor` string
- `date_from` string
- `date_to` string
- `action` string
- `entity_type` string
- `limit` integer
- `cursor` string

## Headers

- `X-Request-Id` string

## Response `200`

Indicates that the request was successful and the response contains the expected data.

- ListAuditLogsResponse — Paginated list of audit log entries
  - `hasMore` boolean
  - `items` AuditLogResponse[] — List of audit log entries
    - `action` string — Action that was performed
    - `actorId` string — ID of the actor who performed the action
    - `changes` integer[] — Changes made to the entity
    - `createdAt` string — Creation timestamp in RFC3339 format
    - `entityId` string — ID of the entity that was modified
    - `entityType` string — Type of entity that was modified
    - `id` string — Unique identifier for the audit log entry
    - `tenantId` string — Tenant ID that owns this audit log entry
    - `truncated` boolean — True when the original audit diff exceeded the payload cap and was replaced with a truncation marker
    - `originalSize` integer — Byte size of the original diff before truncation; zero when not truncated
  - `limit` integer
  - `nextCursor` string
  - `prevCursor` string

## Other responses

- `400` — The request contains invalid parameters or payload.
- `401` — The request lacks valid authentication credentials.
- `403` — You do not have permission to access this resource.
- `500` — An unexpected error occurred on the server.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)