---
title: "Get session by ID"
method: GET
path: "/api/session/{id}"
---

# Get session by ID

`GET /api/session/{id}`

## Path parameters

- `id` string, required

## Response `200`

Session details

- SessionDetail
  - `id` string, uuid
  - `teamId` string, uuid
  - `status` 'active' | 'closed' | 'error' | 'close-error'
  - `startTime` string, timestamp-milliseconds, nullable
  - `endTime` string, timestamp-milliseconds, nullable
  - `createdAt` string, iso8601
  - `updatedAt` string, iso8601
  - `launchState` SessionLaunchState, nullable
    - `useUltraStealth` boolean
    - `useStealth` boolean
    - `useProxy` boolean
    - `solveCaptchas` boolean
    - `solverType` 'visual' — Optional CAPTCHA solver mode. Set to visual to use the visual reCAPTCHA solver.
    - `adblock` boolean
    - `trackers` boolean
    - `annoyances` boolean
    - `screen` ScreenConfig
      - `width` number
      - `height` number
    - `enableWebRecording` boolean
    - `enableVideoWebRecording` boolean
    - `enableLogCapture` boolean
    - `acceptCookies` boolean
    - `profile` CreateSessionProfile
      - `id` string
      - `persistChanges` boolean
      - `persistNetworkCache` boolean — When persisting profile changes, also persist the browser's network cache (HTTP cache).
    - `staticIpId` string
    - `saveDownloads` boolean
    - `enableWindowManager` boolean
    - `enableWindowManagerTaskbar` boolean
    - `viewOnlyLiveView` boolean
    - `disablePasswordManager` boolean
    - `enableAlwaysOpenPdfExternally` boolean
    - `disablePostQuantumKeyAgreement` boolean
  - `creditsUsed` number, nullable
  - `sessionUrl` string
  - `liveUrl` string
  - `token` string
  - `wsEndpoint` string
  - `webdriverEndpoint` string
  - `computerActionEndpoint` string

## Other responses

- `404` — Session not found

## Changes

> 5 revisions in range; 2 could not be searched.

- **2026-08-06** `69aa004ce41b` — 1 warning
  - added the new `close-error` enum value to the `allOf[#/components/schemas/Session]/status` response property for the response status `200`

[Change history](https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api/changes/api/session/:id/get.md)

---

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