---
title: "Get Browser Session"
method: GET
path: "/v1/browser/session"
---

# Get Browser Session

`GET /v1/browser/session`

Retrieve an existing browser session.

## Query parameters

- `sessionId` string, required — The ID of the browser session to retrieve.

## Response `200`

Successfully retrieved browser session.

- object
  - `sessionId` string, required — The ID of the created browser session.
  - `status` 'starting' | 'active' | 'completed' | 'error', required — The status of the session.
  - `servedBy` string, required — The node ID that is serving this session.
  - `createdAt` string, required — The ISO 8601 timestamp when the session was created.
  - `stoppedAt` string, nullable, required — The ISO 8601 timestamp when the session was stopped, or null if it is still active.
  - `cdpUrl` string, uri, nullable, required — The URL to access the Chrome DevTools Protocol for this session, or null if not available.
  - `note` string, nullable, required — An optional note attached to the session, or null if not set.
  - `bandwidthBytes` integer — The total bandwidth used by the session in bytes.

## Other responses

- `401` — Missing or invalid token.
- `404` — Browser session not found.
- `500` — Failed to retrieve browser session.

## Changes

- **2026-06-10** `fe4827822116` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/browsercash/apis/driver-api/changes/v1/browser/session/get.md)

---

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