---
title: "GET /playwrightworkspaces/{workspaceId}/browser-sessions"
method: GET
path: "/playwrightworkspaces/{workspaceId}/browser-sessions"
---

# GET /playwrightworkspaces/{workspaceId}/browser-sessions

`GET /playwrightworkspaces/{workspaceId}/browser-sessions`

Lists browser sessions for the specified workspace ID. Supports OData query parameters such as $filter and $top. Default page size is 10. Use nextLink in response to fetch additional results. Requires Bearer JWT access token provided by Entra ID.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `api-version` string, required

## Headers

- `x-ms-client-request-id` string, uuid
- `x-ms-useragent` string

## Response `200`

The request has succeeded.

- PagedBrowserSession — Paged collection of BrowserSession items
  - `value` BrowserSession[], required — The BrowserSession items on this page
    - `id` string, required — The browser session ID in GUID format.
    - `displayName` string, required — The browser session display name.
    - `creatorId` string, required — The browser session creator's ID.
    - `startTime` string, date-time — The browser session start time in UTC.
    - `endTime` string, date-time — The browser session end time in UTC.
    - `durationInMilliseconds` integer — The browser session duration in milliseconds.
    - `status` 'Created' | 'Active' | 'Completed' | 'Failed', required — The browser session status.
    - `source` BrowserSessionSource, required — The browser session source details.
      - `id` string, required — The browser session source ID, would be same as runId for test-runs.
      - `type` 'PlaywrightWorkspacesTestRun' | 'BrowserAutomationTool' | 'Others', required — The browser session source type.
    - `browserType` 'Chromium' | 'Firefox' | 'Webkit', required — The browser type to configure for remote script execution.
    - `operatingSystem` 'Linux' | 'Windows', required — The operating system to configure for remote script execution.
  - `nextLink` string, uri — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2025-07-01-preview) `7e7fa8e8788b` — 1 info
  - endpoint added
- **2025-06-26** (2025-07-01-preview) `fbb0d3fa1f18` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/loadtestservice-playwright/changes/playwrightworkspaces/:workspaceId/browser-sessions/get.md)

---

[API](https://skmtc.dev/azure/apis/loadtestservice-playwright.md) · [All operations](https://skmtc.dev/azure/apis/loadtestservice-playwright/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/loadtestservice-playwright/revisions/7e7fa8e8788b/schema)