Get Event

GET /api/v1/events/

Retrieve a single event by its UUID. The response includes the full event data and the integrity block.

Path Parameters

string

required

The UUID of the event.

Response

{
  "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "actor": {
    "id": "user_2hG9kLm",
    "name": "Sarah Chen",
    "type": "user"
  },
  "action": "document.created",
  "action_category": "documents",
  "resource": {
    "type": "document",
    "id": "doc_8nXpQr3",
    "name": "Q4 Financial Report"
  },
  "metadata": {
    "folder": "reports",
    "template": "quarterly"
  },
  "targets": [
    { "type": "folder", "id": "folder_3mK9pLq", "name": "Shared Reports" }
  ],
  "tenant_id": "org_7rT2xBc",
  "session_id": "sess_4kN8pLm",
  "ip_country": "US",
  "ip_city": "San Francisco",
  "idempotency_key": null,
  "version": null,
  "integrity": {
    "event_hash": "a3f2c8d1e4b567890abcdef1234567890abcdef1234567890abcdef12345678",
    "previous_event_hash": "7b9e1d3f5a2c67890abcdef1234567890abcdef1234567890abcdef12345678"
  },
  "occurred_at": "2026-03-15T14:32:18.847312Z",
  "created_at": "2026-03-15T14:32:18.847312Z"
}

Integrity Block

integrity.event_hash

string | null

SHA-256 hash of this event’s data combined with the previous event hash.

integrity.previous_event_hash

string | null

SHA-256 hash of the preceding event in the workspace chain. null for the first event.

See Hash Chain for details on how hashes are computed.

Examples

curl https://getimmutable.dev/api/v1/events/9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d \
  -H "Authorization: Bearer imk_your_api_key_here"

const event = await client.getEvent("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d");

console.log(event.actor.id);                     // "user_2hG9kLm"
console.log(event.integrity.event_hash);          // "a3f2c8d1..."
console.log(event.integrity.previous_event_hash); // "7b9e1d3f..."

$event = AuditLog::getEvent('9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d');

$event['integrity']['event_hash'];
$event['integrity']['previous_event_hash'];

Errors

Status	Description
`404`	Event not found or outside retention window.

Overview

Events

Verification

Exports

Anchors

Other

GET /api/v1/events/

Path Parameters

Response

Integrity Block

Examples

Errors

​GET /api/v1/events/

​Path Parameters

​Response

​Integrity Block

​Examples

​Errors

GET /api/v1/events/

Path Parameters

Response

Integrity Block

Examples

Errors