---
title: "List Browser Sessions"
method: GET
path: "/v1/browser/sessions"
---

# List Browser Sessions

`GET /v1/browser/sessions`

List browser sessions with pagination.

## Query parameters

- `page` integer — The page number for pagination.
- `pageSize` integer — The number of sessions per page.
- `status` 'starting' | 'active' | 'completed' | 'error' — Filter sessions by status.

## Response `200`

Successfully retrieved list of browser sessions.

- object
  - `page` integer, required — The current page number.
  - `pageSize` integer, required — The number of sessions per page.
  - `total` integer, required — The total number of sessions.
  - `totalPages` integer, required — The total number of pages.
  - `sessions` object[], required — Array of browser sessions.
    - `sessionId` string, required — The unique session ID.
    - `status` 'starting' | 'active' | 'completed' | 'error', required — The status of the session.
    - `servedBy` string, required — The node ID that is serving this session.
    - `type` 'hosted', nullable, required — Session infrastructure type. Public docs only expose hosted sessions.
    - `country` string, nullable, required — The ISO country code of the node 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.
    - `bandwidthBytes` integer — The total bandwidth used by the session in bytes.
    - `note` string, nullable, required — An optional note attached to the session, or null if not set.

## Other responses

- `401` — Missing or invalid token.
- `500` — Failed to retrieve browser sessions.

## Changes

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

[Change history](https://skmtc.dev/browsercash/apis/driver-api/changes/v1/browser/sessions/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)