---
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).

---

[API](https://skmtc.net/browserbase/apis/browserbase-api.md) · [All operations](https://skmtc.net/browserbase/apis/browserbase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/browserbase/browserbase-api/versions/832b22144edf/schema)