---
title: "Get a Session"
method: GET
path: "/v1/sessions/{id}"
---

# Get a Session

`GET /v1/sessions/{id}`

## Path parameters

- `id` string, required

## Response `200`

The request has succeeded.

- object
  - `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).
  - `connectUrl` string, uri — WebSocket URL to connect to the Session.
  - `seleniumRemoteUrl` string, uri — HTTP URL to connect to the Session.
  - `signingKey` string — Signing key to use when connecting to the Session via HTTP.

## Changes

- **2026-05-13** `3cb839210d89` — 1 warning
  - added the new `PENDING` enum value to the `allOf[#/components/schemas/Session]/status` response property for the response status `200`
- **2026-02-26** `215bc4361122` — 11 breaking, 6 warning, 1 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `createdAt` from the response with the `200` status
  - removed the required property `expiresAt` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - …14 more
- **2026-02-26** `a2379f6bf614` — 3 breaking, 6 warning, 3 info
  - the `contextId` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `projectId` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `region` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - removed the optional property `avgCpuUsage` from the response with the `200` status
  - …8 more
- **2025-03-14** `06206dff3ffa` — 3 info
  - added the optional property `connectUrl` to the response with the `200` status
  - added the optional property `seleniumRemoteUrl` to the response with the `200` status
  - added the optional property `signingKey` to the response with the `200` status
- **2025-01-28** `396a2b9092f6` — 1 info
  - added the optional property `userMetadata` to the response with the `200` status

[Full history](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/sessions/:id/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/550634919db9/schema)