---
title: "List audit log entries"
method: GET
path: "/v1/audit-logs"
tags: ["Audit Logs"]
---

# List audit log entries

`GET /v1/audit-logs`

Returns a paginated list of organization-level audit log entries. Requires the Enterprise plan, Admin role, and a non-agentic API key.

## Query parameters

- `search` string
- `actions` string
- `resource_types` string
- `date_from` string, date-time
- `date_to` string, date-time
- `page` integer
- `page_size` integer

## Response `200`

A paginated list of audit log entries.

- object
  - `data` object[], required — List of audit log entries for the current page.
    - `id` string, required — Unique entry ID (UUID).
    - `action` string, required — Action key, e.g. `repository_create`.
    - `actionLabel` string, required — Human-readable action label, e.g. `Added repository`.
    - `resourceType` string, required — Resource type key, e.g. `repository`.
    - `resourceTypeLabel` string, required — Human-readable resource type label, e.g. `Repository`.
    - `resourceSummary` string, required — Short description of the affected resource.
    - `actor` object, required — The user or system that performed the action.
      - `name` string, required — Display name of the actor.
      - `subtitle` string, required — Actor role label when available, otherwise the underlying actor type.
      - `isBot` boolean, required — Whether the actor is a bot.
      - `avatarUrl` string, nullable, required — Avatar URL, if available.
    - `metadata` object, nullable, required — Action-specific payload. Contents vary by action type.
    - `ipAddress` string, nullable, required — IP address of the request that triggered the action.
    - `createdAt` string, date-time, required — ISO 8601 timestamp of when the action occurred.
    - `relativeTime` string, required — Human-readable relative time, e.g. `1d ago`.
  - `pagination` object, required — Pagination metadata.
    - `page` integer, required — Current page number.
    - `page_size` integer, required — Number of results per page.
    - `total_count` integer, required — Total number of matching entries.
    - `total_pages` integer, required — Total number of pages.
    - `has_next_page` boolean, required — Whether a next page is available.
    - `has_previous_page` boolean, required — Whether a previous page is available.
  - `filter_options` object, required — Distinct action and resource type values present in the organization's log, useful for building filter UIs.
    - `actions` object[], required
      - `value` string, required — Action key.
      - `label` string, required — Human-readable label.
      - `count` integer, required — Number of matching entries.
    - `resource_types` object[], required
      - `value` string, required — Resource type key.
      - `label` string, required — Human-readable label.
      - `count` integer, required — Number of matching entries.

## Other responses

- `400` — Invalid request. Possible error codes: `INVALID_PARAMETER`, `TOO_MANY_ITEMS`, `INVALID_DATE_RANGE`.
- `401` — Invalid or missing API key.
- `403` — Access denied. Possible error codes: `NOT_ADMIN`, `KEY_TYPE_FORBIDDEN`, `ENTERPRISE_PLAN_REQUIRED`.
- `410` — Legacy API key used (`LEGACY_API_KEY`).
- `429` — Rate limit exceeded (`RATE_LIMIT_EXCEEDED`).
- `500` — Internal server error (`INTERNAL_ERROR`).

---

[API](https://skmtc.net/coderabbit/apis/coderabbit-api-spec.md) · [All operations](https://skmtc.net/coderabbit/apis/coderabbit-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coderabbit/coderabbit-api-spec/versions/401789d85d01/schema)