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

# List Sessions

`GET /v1/sessions`

## Query parameters

- `status` 'PENDING' | 'RUNNING' | 'ERROR' | 'TIMED_OUT' | 'COMPLETED'
- `q` string

## Response `200`

The request has succeeded.

- Session[]
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `projectId` string, required — The Project ID linked to the Session.
  - `startedAt` string, date-time, required
  - `endedAt` string, date-time
  - `expiresAt` string, date-time, required
  - `status` 'PENDING' | 'RUNNING' | 'ERROR' | 'TIMED_OUT' | 'COMPLETED', required
  - `proxyBytes` integer, required — Bytes used via the [Proxy](/features/stealth-mode#proxies-and-residential-ips)
  - `keepAlive` boolean, required — Indicates if the Session was created to be kept alive upon disconnections
  - `contextId` string — Optional. The Context linked to the Session.
  - `region` 'us-west-2' | 'us-east-1' | 'eu-central-1' | 'ap-southeast-1', required — The region where the Session is running.
  - `userMetadata` object — Arbitrary user metadata to attach to the session. To learn more about user metadata, see [User Metadata](/features/sessions#user-metadata).

## Changes

- **2026-05-13** `3cb839210d89` — 1 warning, 1 info
  - added the new `PENDING` enum value to the `items/status` response property for the response status `200`
  - added the new enum value `PENDING` to the `query` request parameter `status`
- **2026-02-26** `a2379f6bf614` — 3 breaking, 6 warning, 3 info
  - the `items/contextId` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `items/projectId` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `items/region` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - removed the optional property `items/avgCpuUsage` from the response with the `200` status
  - …8 more
- **2025-01-28** `396a2b9092f6` — 2 info
  - added the new optional `query` request parameter `q`
  - added the optional property `items/userMetadata` to the response with the `200` status
- **2024-10-27** `b37d85811d1c` — 4 info
  - removed `#/components/schemas/Entity` from the `items/` response property `allOf` list for the response status `200`
  - added the required property `items/createdAt` to the response with the `200` status
  - added the required property `items/id` to the response with the `200` status
  - added the required property `items/updatedAt` to the response with the `200` status
- **2024-10-27** `0d0ad7d4de2f` — 1 info
  - added the required property `items/region` to the response with the `200` status

[Full history](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/sessions/get.md)

---

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