---
title: "Stream telemetry events via SSE"
method: GET
path: "/browsers/{id_or_name}/telemetry/stream"
tags: ["Browser Telemetry"]
---

# Stream telemetry events via SSE

`GET /browsers/{id_or_name}/telemetry/stream`

## Request

- Base URL: `https://api.onkernel.com`
- URL: `https://api.onkernel.com/browsers/{id_or_name}/telemetry/stream`
- Auth: HTTP bearer

Streams browser telemetry events as a server-sent events (SSE) stream. The stream closes when the browser session terminates. Each event frame includes an id: field containing a monotonically increasing sequence number; pass it as Last-Event-ID on reconnect to resume without gaps. The event: field is never set; event frames carry JSON in the data: field. A frame with an id: field and no data: field moves Last-Event-ID past events that were not delivered, because a type filter excluded them or they could not be decoded or exceeded the size limit; SSE clients dispatch no event for it. A keepalive comment frame is sent every 15 seconds when no events arrive. Returns 404 if the browser session does not exist. If telemetry was not enabled on the session, the stream opens but no events are delivered. Fresh connections only see new events; pass replay=all to start from the oldest retained event instead.

## Path parameters

- `id_or_name` string, required

## Query parameters

- `replay` string
- `type` string[]

## Headers

- `Last-Event-ID` string

## Response `200`

SSE stream of telemetry events

## Other responses

- `401`: Unauthorized – missing or invalid authorization token
- `403`: Forbidden – insufficient permissions or plan
- `404`: Resource not found
- `500`: Internal Server Error
- `default`: Error returned by the browser or its proxy

## Changes

- **2026-10-29** `4d99d0b5955a`: 1 warning
  - added the new `payment_window_expired` enum value to the `event/oneOf[subschema #7: proxy_error]/data/allOf[subschema #2]/code` response property for the response status `200`

[Operation history](https://skmtc.dev/kernel/apis/kernel-api/changes/browsers/:id_or_name/telemetry/stream/get.md)

---

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