---
title: "Get Event By Id"
method: GET
path: "/v1/workspaces/{workspace}/streams/events/{event_id}"
tags: ["v1", "protected", "streams"]
---

# Get Event By Id

`GET /v1/workspaces/{workspace}/streams/events/{event_id}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

One event by its id, whichever stream holds it: what a forward or a cause points at.

## Path parameters

- `event_id` string, uuid, required
- `workspace` string, required: Slug of the workspace the request acts in

## Response `200`

Successful Response

- StreamEventDetailResponse
  - `attachments` EventAttachmentResponse[], required
    - `mime` string, nullable, required
    - `name` string, required
    - `ref` string, required: A workspace file path, or the provider's reference (JSON).
    - `sha256` string, nullable, required
    - `size` integer, nullable, required
    - `url` string, nullable, required: Download link for a stored file; null for a provider's reference.
  - `body_url` string, nullable, required: Download link for data.body_ref; null without one.
  - `causation_id` string, nullable, required
  - `correlation_id` string, nullable, required
  - `data` object, required: {headers, body, body_ref}: the request as sent.
  - `depth` integer, required
  - `event_id` string, uuid, required
  - `handlers` HandlerResponse[], required: One per subscription that reacted so far; the rest are still to come.
    - `derived_event_ids` string[], required
    - `kind` string, required: trigger, forward, or deleted
    - `name` string, required: The trigger's name, or the streams a forward writes to.
    - `reason` string, nullable, required
    - `subscription_id` string, uuid, required
    - `task_id` string, uuid, nullable, required
    - `task_status` string, nullable, required
    - `verdict` string, required: reacted, skipped, error, or batched while it waits in an open batch
  - `key` string, required
  - `kind` string, required
  - `occurred_at` string, date-time, required
  - `outcomes` OutcomeResponse[], required: One per subscription that took the event; empty means nobody listened.
    - `created_at` string, date-time, required
    - `derived_event_ids` string[], required: Events a forward wrote into its output streams, in output-stream order.
    - `event_id` string, uuid, required
    - `reason` string, nullable, required
    - `score` number, nullable, required
    - `subscription_id` string, uuid, required
    - `subscription_kind` string, required
    - `task_id` string, uuid, nullable, required
    - `trigger_id` string, uuid, nullable, required
    - `verdict` string, required: reacted, skipped, error, or batched while it waits in an open batch
  - `processing` Processing
    - `errors` integer, required
    - `reacted` integer, required: Subscriptions whose reaction is recorded.
    - `skipped` integer, required
    - `status` 'queued' | 'processing' | 'handled' | 'error' | 'no_handlers' | 'skipped', required
    - `subscribers` integer, nullable, required: Subscriptions the router matched; null until it routed the event.
    - `tasks` ProcessingTask[]
      - `id` string, uuid, required
      - `status` string, required
  - `received_at` string, date-time, required
  - `sender` string, nullable, required
  - `sequence` integer, required
  - `session_key` string, nullable, required
  - `source_id` string, uuid, nullable, required
  - `source_type` string, nullable, required
  - `stream_id` string, uuid, required
  - `v` integer

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `1d8a3995ec6c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/streams/events/:event_id/get.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) - [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentarea/apis/agentarea-api/revisions/5b651833a114?raw)