---
title: "List audit events"
method: GET
path: "/v0/admin/audit"
tags: ["Admin"]
---

# List audit events

`GET /v0/admin/audit`

## Request

- Base URL: `https://docs.quivr.thevibecompany.co` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.quivr.thevibecompany.co/v0/admin/audit`
- Auth: HTTP bearer

List immutable sensitive-action entries for the API key's organization, newest first. Requires audit:read and organization-wide Corpus scope. Time filters are RFC3339 instants; since is inclusive and until exclusive. Cursors bind organization, permissions and filters including limit; reuse the same filters on later pages. Reads and searches are not audited.

## Query parameters

- `since` string, date-time
- `until` string, date-time
- `actor` string
- `action` string
- `target_type` string
- `target_id` string
- `limit` integer
- `page_cursor` string

## Response `200`

An organization-scoped page of audit entries.

- AuditEventPage
  - `items` AuditEvent[], required
    - `id` string, required: Decimal audit identifier, represented as text to preserve bigint precision.
    - `time` string, date-time, required
    - `actor` string, required: SHA-256-derived API key identifier; empty for unauthenticated attempts.
    - `action` string, required
    - `target_type` string, required
    - `target_id` string, required: Target identifier; empty if refusal occurred before the target could be resolved.
    - `organization` string, required
    - `outcome` 'accepted' | 'refused', required
    - `request_id` string, required
    - `detail` object, required
      - `status` integer, required
      - `error_code` string
      - `plan_id` string
      - `credential_version` integer
  - `next_page_cursor` string

## Other responses

- `default`: Structured error; 401 invalid API key, 403 without audit:read or with restricted Corpus scope, 422 invalid_cursor, 422 invalid_schema or invalid_limit, 503 storage_unavailable.

---

[API](https://skmtc.dev/thevibecompany/apis/quivr-http-api.md) - [All operations](https://skmtc.dev/thevibecompany/apis/quivr-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thevibecompany/apis/quivr-http-api/revisions/4f4e30ba8f4e?raw)