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

---

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