---
title: "Stream auth session events (SSE)"
method: GET
path: "/api/v1/auth/sessions/{id}/events"
tags: ["Auth"]
---

# Stream auth session events (SSE)

`GET /api/v1/auth/sessions/{id}/events`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/auth/sessions/{id}/events`
- Auth: none declared

Subscribe to real-time auth session status updates via Server-Sent Events. Public endpoint — session ID acts as bearer secret (same access model as GET /auth/sessions/:id). Sends `connected` event on open, then `update` events when the session status changes (e.g., verified). Includes heartbeat to keep connection alive through Cloudflare.

## Path parameters

- `id` string, required: Auth session ID

## Response `200`

SSE event stream

## Other responses

- `404`: Session not found
- `429`: Too many concurrent SSE connections

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/6b8d61ee354f?raw)