---
title: "List audit events for the caller's account"
method: GET
path: "/v1/audit"
tags: ["audit"]
---

# List audit events for the caller's account

`GET /v1/audit`

## Request

- Base URL: `https://api.ctindex.io`
- URL: `https://api.ctindex.io/v1/audit`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns the most recent audit events for the authenticated tenant, newest first. Use ``cursor`` for pagination. Filter with ``since``/``until`` (RFC 3339) and/or ``event_type`` (exact match; repeat the query param to OR multiple types).

## Query parameters

- `since` string, date-time, nullable: Inclusive lower bound (RFC 3339).
- `until` string, date-time, nullable: Exclusive upper bound (RFC 3339).
- `event_type` string[], nullable: Filter by event_type.
- `cursor` string, nullable: Opaque cursor from a previous response.
- `limit` integer

## Cookies

- `ctix_session` string, nullable

## Response `200`

Successful Response

- AuditListResponse
  - `results` AuditEvent[], required
    - `id` string, uuid, required
    - `timestamp` string, date-time, required
    - `event_type` string, required
    - `subject` string, nullable
    - `actor_ip` string, nullable
    - `actor_user_agent` string, nullable
    - `metadata` object
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

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