Skip to main content

​
GET /api/v1/events/

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

​
Path Parameters

​
id
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"

​
Errors

StatusDescription
404Event not found or outside retention window.