> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getimmutable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Event

> Retrieve a single event by ID with its integrity proof.

## GET /api/v1/events/{id}

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

### Path Parameters

<ParamField path="id" type="string" required>
  The UUID of the event.
</ParamField>

### Response

```json theme={null}
{
  "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

<ResponseField name="integrity.event_hash" type="string | null">
  SHA-256 hash of this event's data combined with the previous event hash.
</ResponseField>

<ResponseField name="integrity.previous_event_hash" type="string | null">
  SHA-256 hash of the preceding event in the workspace chain. `null` for the first event.
</ResponseField>

See [Hash Chain](/guides/hash-chain) for details on how hashes are computed.

### Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://getimmutable.dev/api/v1/events/9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d \
    -H "Authorization: Bearer imk_your_api_key_here"
  ```

  ```typescript JavaScript theme={null}
  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..."
  ```

  ```php Laravel theme={null}
  $event = AuditLog::getEvent('9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d');

  $event['integrity']['event_hash'];
  $event['integrity']['previous_event_hash'];
  ```
</CodeGroup>

### Errors

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