---
title: "Subscribe to live call events (SSE)"
method: GET
path: "/events"
tags: ["Live Transcripts"]
---

# Subscribe to live call events (SSE)

`GET /events`

Real-time streaming of user speech (STT) and agent speech (TTS) events for an active call via Server-Sent Events.

The connection is real-time — events stream directly from the call runtime as they are produced. The SSE connection auto-closes when the call ends (`sse_close` event). Only active calls can be subscribed to; completed calls return a 400 error.

**Transcript event types:**

- `user_interim_transcription` — Partial, in-progress transcription as the user speaks. Use for live preview only; will be superseded by `user_transcription`.
- `user_transcription` — Final transcription for a completed user speech turn.
- `tts_completed` — Fired when the agent finishes speaking a TTS segment. Includes the spoken text and optionally TTS latency.

**Lifecycle events:**

- `sse_init` — Sent immediately when the SSE connection is established.
- `sse_close` — Sent when the call ends, right before the server closes the connection.

Other event types (e.g. `tool_call_start`, `pre_call_api`, `agent_log`, metrics) are also sent on this stream.

- `call_start`
- `call_end`
- `turn_latency`
- `metrics`
- `agent_node_state`
- `hopping`
- `knowledgebase`
- `variable_extraction`
- `pre_call_api`
- `post_call_api`
- `agent_error`
- `agent_log`
- `tool_call_start`
- `tool_call_end`
- `tool_call_error`
- `call_cancelled`
- `call_recording`

## Query parameters

- `callId` string, required

## Headers

- `X-Organization-Id` string

## Response `200`

SSE event stream established successfully

## Other responses

- `400` — Missing or invalid `callId`, missing or invalid organization header, or call is already completed.
- `401` — Missing or invalid bearer token or session.
- `403` — User is not a member of the organization or does not have member access.
- `404` — Organization not found, call log not found, or agent not found/org mismatch.
- `500` — Internal server error.

## Changes

- **2026-06-21** `7aec6f3099de` — 1 breaking
  - the `metrics` response's property type/format changed from `object`/`` to `array`/`` for status `200`
- **2026-05-26** `ff0bafe7239a` — 17 warning, 46 info
  - added the new `agent_error` enum value to the `event_type` response property for the response status `200`
  - added the new `agent_log` enum value to the `event_type` response property for the response status `200`
  - added the new `agent_node_state` enum value to the `event_type` response property for the response status `200`
  - added the new `call_cancelled` enum value to the `event_type` response property for the response status `200`
  - …59 more
- **2026-04-20** `801f1d220d57` — 1 warning, 3 info
  - removed the optional property `data` from the response with the `404` status
  - api tag `Live Transcripts` added
  - api tag `Calls` removed
  - added the optional property `errors` to the response with the `404` status
- **2026-03-09** `0e98bc4f6f53` — 2 info
  - api tag `Calls` added
  - api tag `Live Transcripts` removed
- **2026-03-09** `f3e752a2714d` — 2 warning, 10 info
  - removed the optional property `message` from the response with the `400` status
  - removed the optional property `message` from the response with the `404` status
  - added the optional property `call_id` to the response with the `200` status
  - added the optional property `data` to the response with the `404` status
  - …8 more

[Full history](https://skmtc.dev/smallest-inc/apis/agent-management-api/changes/events/get.md)

---

[API](https://skmtc.dev/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.dev/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/ea4ea58d7c4e/schema)