---
title: "Retrieve an Audit event"
method: GET
path: "/v1/audit-events/{auditEventId}"
tags: ["History"]
---

# Retrieve an Audit event

`GET /v1/audit-events/{auditEventId}`

## Request

- Base URL: `https://hyperscale0.ai`
- URL: `https://hyperscale0.ai/v1/audit-events/{auditEventId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Retrieve a single Audit event by its auditEventId. One entry in the tamper-evident audit chain: which principal acted, on which resource, and when. Entries are append-only and hash-chained, so a removed or edited entry is detectable.

## Path parameters

- `auditEventId` string, required

## Query parameters

- `productId` string: Hyperscale product ID

## Headers

- `X-Hyperscale-Environment` 'sandbox' | 'live'

## Response `200`

Success

- AuditEventRetrieveOutput
  - `auditEventId` string, required: Hyperscale audit event ID
  - `tenantId` string, required: Organization tenant ID
  - `title` string
  - `actorName` string
  - `productName` string
  - `event` string
  - `principalId` string: Hyperscale principal ID
  - `userId` string
  - `operationId` string: Hyperscale operation ID
  - `requestId` string
  - `resourceKind` string
  - `resourceId` string
  - `digest` string
  - `prevDigest` string
  - `chainVersion` string, required
  - `createdAt` string, date-time

## Other responses

- `default`: ErrorResponse. See x-error-codes and x-errors for codes, HTTP statuses and retry guidance.

---

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