---
title: "Get list of sessions"
method: GET
path: "/api/sessions"
---

# Get list of sessions

`GET /api/sessions`

## Query parameters

- `page` number
- `status` 'active' | 'closed' | 'error' | 'close-error'

## Response `200`

List of sessions

- object
  - `sessions` Session[]
    - `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
  - `totalCount` number
  - `page` number
  - `pageSize` number

## Other responses

- `400` — Invalid query parameters
- `500` — Server error

---

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