---
title: "Get session details"
method: GET
path: "/v1/sessions/{id}"
tags: ["Sessions"]
---

# Get session details

`GET /v1/sessions/{id}`

Retrieves details of a specific session by ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

Represents the data structure for a browser session, including its configuration and status.

- SessionResponse — Represents the data structure for a browser session, including its configuration and status.
  - `createdAt` string, date-time, required — Timestamp when the session started
  - `creditsUsed` integer, required — Amount of credits consumed by the session
  - `debugConfig` object — Configuration for the debug URL and session viewer. Controls interaction capabilities and cursor visibility.
    - `interactive` boolean — Whether interaction is allowed via the debug URL viewer. When false, the session viewer is view-only.
    - `systemCursor` boolean — Whether the OS-level mouse cursor is shown in the WebRTC stream (headful mode only).
  - `debugUrl` string, required — URL for debugging the session
  - `deviceConfig` object — Device configuration for the session
    - `device` 'desktop' | 'mobile'
  - `dimensions` object, required — Viewport and browser window dimensions for the session
    - `height` integer, required — Height of the browser window
    - `width` integer, required — Width of the browser window
  - `duration` integer, required — Duration of the session in milliseconds
  - `eventCount` integer, required — Number of events processed in the session
  - `fullscreen` boolean — Launch the browser in fullscreen mode, covering the full screen with no Chrome UI.
  - `headless` boolean — Indicates if the session is headless or headful
  - `id` string, uuid, required — Unique identifier for the session
  - `inactivityTimeout` integer — Inactivity timeout in milliseconds, if one was set when the session was created
  - `isSelenium` boolean — Indicates if Selenium is used in the session
  - `optimizeBandwidth` object, required — Bandwidth optimizations that were applied to the session.
    - `blockHosts` string[]
    - `blockImages` boolean
    - `blockMedia` boolean
    - `blockStylesheets` boolean
    - `blockUrlPatterns` string[]
  - `persistProfile` boolean — This flag will persist the profile for the session.
  - `profileId` string, uuid — The ID of the profile associated with the session
  - `projectId` string, uuid, nullable — The project associated with the session
  - `proxyBytesUsed` integer, required — Amount of data transmitted through the proxy
  - `proxySource` 'steel' | 'external', nullable, required — Source of the proxy used for the session
  - `region` 'lax' | 'ord' | 'iad' | 'scl' | 'fra' | 'nrt' | 'us-east' | 'us-west' | 'us-central' | 'eu-west' | 'eu-central' | 'ap-northeast' | 'ap-southeast' | 'sa-east' — The region where the session was created.
  - `releaseReason` 'user_requested' | 'timeout' | 'inactivity_timeout' | 'creation_timeout' | 'startup_failed' | 'browser_closed' | 'browser_crashed', nullable — Why the session reached a terminal state. Null while the session is live, or when the reason is unknown (e.g. sessions created before this was tracked). One of: user_requested (released via the API/SDK), timeout (hard `timeout` elapsed), inactivity_timeout (no activity for the configured window), creation_timeout (never started in time), startup_failed (could not be dispatched), browser_closed (the browser or agent closed itself — not a crash), browser_crashed (the browser crashed or its machine became unresponsive).
  - `sessionViewerUrl` string, required — URL to view session details
  - `solveCaptcha` boolean — Indicates if captcha solving is enabled
  - `status` 'live' | 'released' | 'failed', required — Status of the session
  - `stealthConfig` object — Stealth configuration for the session
    - `autoCaptchaSolving` boolean — When true, captchas will be automatically solved when detected. When false, use the solve endpoints to manually initiate solving.
    - `humanizeInteractions` boolean — This flag will make the browser act more human-like by moving the mouse in a more natural way
    - `skipFingerprintInjection` boolean — This flag will skip the fingerprint generation for the session.
  - `timeout` integer, required — Session timeout duration in milliseconds
  - `userAgent` string — User agent string used in the session
  - `websocketUrl` string, required — URL for the session's WebSocket connection

## Other responses

- `400` — An error response from the API
- `404` — An error response from the API
- `500` — An error response from the API

## Changes

- **2026-06-18** `416b04cf01b1` — 1 info
  - added the optional property `releaseReason` to the response with the `200` status
- **2026-06-07** `4985d7bcd32f` — 5 info
  - added the optional property `inactivityTimeout` to the response with the `200` status
  - added the optional property `linkToDocs` to the response with the `400` status
  - added the optional property `linkToDocs` to the response with the `404` status
  - added the optional property `linkToDocs` to the response with the `500` status
  - …1 more
- **2026-05-22** `39bc3eb693fb` — 6 warning
  - added the new `fra` enum value to the `region` response property for the response status `200`
  - added the new `iad` enum value to the `region` response property for the response status `200`
  - added the new `lax` enum value to the `region` response property for the response status `200`
  - added the new `nrt` enum value to the `region` response property for the response status `200`
  - …2 more
- **2026-05-18** `4903de8a2ac2` — 8 warning, 6 info
  - added the new `ap-northeast` enum value to the `region` response property for the response status `200`
  - added the new `ap-southeast` enum value to the `region` response property for the response status `200`
  - added the new `eu-central` enum value to the `region` response property for the response status `200`
  - added the new `eu-west` enum value to the `region` response property for the response status `200`
  - …10 more
- …earlier changes not shown

[Full history](https://skmtc.dev/steel-dev/apis/steel-api/changes/v1/sessions/:id/get.md)

---

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