---
title: "Scan events (WebSocket)"
method: GET
path: "/ws/scans/{scan_id}"
tags: ["websocket"]
---

# Scan events (WebSocket)

`GET /ws/scans/{scan_id}`

**WebSocket endpoint** — stream real-time events for a specific scan.

Connect with `?last_seq=N` to replay missed events on reconnection.

**Event types:** `progress_update`, `phase_update`, `finding_discovered`, `log`, `scan_complete`, `error`

## Path parameters

- `scan_id` integer, required

## Query parameters

- `last_seq` integer

## Other responses

- `101` — WebSocket upgrade
- `400` — Invalid scan ID

---

[API](https://skmtc.dev/bugtraceai/apis/bugtraceai-cli-api.md) · [All operations](https://skmtc.dev/bugtraceai/apis/bugtraceai-cli-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bugtraceai/bugtraceai-cli-api/revisions/312bfc1148dc/schema)