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

# Changes to List Sessions

`GET /v1/sessions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 45 revisions.

- **2026-05-13** `3cb839210d89`: 1 warning, 1 info
- **2026-02-26** `a2379f6bf614`: 3 breaking, 6 warning, 3 info
- **2025-01-28** `396a2b9092f6`: 2 info
- **2024-10-27** `b37d85811d1c`: 4 info
- **2024-10-27** `0d0ad7d4de2f`: 1 info
- **2024-10-27** `0069ed71133a`: 8 breaking, 10 warning, 9 info
- **2024-10-27** `69e3c041b63e`: 1 warning, 1 info
- **2024-10-26** `208ded3468d1`: 7 breaking, 4 warning, 18 info
- **2024-10-25** `825ce446567d`: 4 info

## 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 changed from no type to `string` for status `200`
  - the `items/projectId` response's property type changed from no type to `string` for status `200`
  - the `items/region` response's property type changed from no type to `string` for status `200`
  - removed the optional property `items/avgCpuUsage` from the response with the `200` status
  - removed the optional property `items/memoryUsage` from the response with the `200` status
  - added the new `ap-southeast-1` enum value to the `items/region` response property for the response status `200`
  - added the new `eu-central-1` enum value to the `items/region` response property for the response status `200`
  - added the new `us-east-1` enum value to the `items/region` response property for the response status `200`
  - added the new `us-west-2` enum value to the `items/region` response property for the response status `200`
  - removed `#/components/schemas/Region` from the `items/region` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/uuid` from the `items/contextId` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/uuid` from the `items/projectId` response property `allOf` list for the response status `200`
- **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
- **2024-10-27** `0069ed71133a`: 8 breaking, 10 warning, 9 info
  - removed the required property `items/created_at` from the response with the `200` status
  - removed the required property `items/expires_at` from the response with the `200` status
  - removed the required property `items/id` from the response with the `200` status
  - removed the required property `items/keep_alive` from the response with the `200` status
  - removed the required property `items/project_id` from the response with the `200` status
  - removed the required property `items/region` from the response with the `200` status
  - removed the required property `items/started_at` from the response with the `200` status
  - removed the required property `items/updated_at` from the response with the `200` status
  - removed the optional property `items/avg_cpu_usage` from the response with the `200` status
  - removed the optional property `items/connectUrl` from the response with the `200` status
  - removed the optional property `items/context_id` from the response with the `200` status
  - removed the optional property `items/ended_at` from the response with the `200` status
  - removed the optional property `items/is_idle` from the response with the `200` status
  - removed the optional property `items/memory_usage` from the response with the `200` status
  - removed the optional property `items/seleniumRemoteUrl` from the response with the `200` status
  - removed the optional property `items/signingKey` from the response with the `200` status
  - removed the optional property `items/viewport_height` from the response with the `200` status
  - removed the optional property `items/viewport_width` from the response with the `200` status
  - added the optional property `items/avgCpuUsage` to the response with the `200` status
  - added the optional property `items/contextId` to the response with the `200` status
  - added the optional property `items/endedAt` to the response with the `200` status
  - added the optional property `items/memoryUsage` to the response with the `200` status
  - added `#/components/schemas/Entity` to the `items/` response property `allOf` list for the response status `200`
  - added the required property `items/expiresAt` to the response with the `200` status
  - added the required property `items/keepAlive` to the response with the `200` status
  - added the required property `items/projectId` to the response with the `200` status
  - added the required property `items/startedAt` to the response with the `200` status
- **2024-10-27** `69e3c041b63e`: 1 warning, 1 info
  - removed the optional property `items/proxy_bytes` from the response with the `200` status
  - added the required property `items/proxyBytes` to the response with the `200` status
- **2024-10-26** `208ded3468d1`: 7 breaking, 4 warning, 18 info
  - removed the required property `items/createdAt` from the response with the `200` status
  - removed the required property `items/expiresAt` from the response with the `200` status
  - removed the required property `items/keepAlive` from the response with the `200` status
  - removed the required property `items/projectId` from the response with the `200` status
  - removed the required property `items/proxyBytes` from the response with the `200` status
  - removed the required property `items/startedAt` from the response with the `200` status
  - removed the required property `items/updatedAt` from the response with the `200` status
  - removed the optional property `items/avgCpuUsage` from the response with the `200` status
  - removed the optional property `items/contextId` from the response with the `200` status
  - removed the optional property `items/endedAt` from the response with the `200` status
  - removed the optional property `items/memoryUsage` from the response with the `200` status
  - added the optional property `items/avg_cpu_usage` to the response with the `200` status
  - added the optional property `items/connectUrl` to the response with the `200` status
  - added the optional property `items/context_id` to the response with the `200` status
  - added the optional property `items/ended_at` to the response with the `200` status
  - added the optional property `items/is_idle` to the response with the `200` status
  - added the optional property `items/memory_usage` to the response with the `200` status
  - added the optional property `items/proxy_bytes` to the response with the `200` status
  - added the optional property `items/seleniumRemoteUrl` to the response with the `200` status
  - added the optional property `items/signingKey` to the response with the `200` status
  - added the optional property `items/viewport_height` to the response with the `200` status
  - added the optional property `items/viewport_width` to the response with the `200` status
  - added the required property `items/created_at` to the response with the `200` status
  - added the required property `items/expires_at` to the response with the `200` status
  - added the required property `items/keep_alive` to the response with the `200` status
  - added the required property `items/project_id` to the response with the `200` status
  - added the required property `items/region` to the response with the `200` status
  - added the required property `items/started_at` to the response with the `200` status
  - added the required property `items/updated_at` to the response with the `200` status
- **2024-10-25** `825ce446567d`: 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

---

[Operation](https://skmtc.dev/browserbase/apis/browserbase-api/docs/v1/sessions/get.md) - [API](https://skmtc.dev/browserbase/apis/browserbase-api.md) - [Page](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/sessions/get)
