---
title: "List Events"
method: GET
path: "/v1/workspaces/{workspace}/streams/{stream_id}/events"
tags: ["v1", "protected", "streams"]
---

# List Events

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

## Request

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

## Path parameters

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

## Query parameters

- `after` integer, nullable: Oldest first, after this sequence.
- `before` integer, nullable: Newest first, before this sequence.
- `limit` integer

## Response `200`

Successful Response

- StreamEventPage
  - `events` StreamEventResponse[], required
    - `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
    - `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
  - `next_after` integer, nullable: With ?after=: pass as ?after= for the next page; null at the end.
  - `next_before` integer, nullable: Without ?after=: pass as ?before= for older events; null at the start.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `1d8a3995ec6c`: 5 breaking, 12 info
  - removed the required property `events/items/event_key` from the response with the `200` status
  - removed the required property `events/items/outcomes/items/derived_sequences` from the response with the `200` status
  - removed the required property `events/items/outcomes/items/event_sequence` from the response with the `200` status
  - removed the required property `events/items/source` from the response with the `200` status
  - …13 more
- **2026-10-06** `5d20495d8e31`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/streams/:stream_id/events/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)