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

Default Response

- SessionResponse — Represents the data structure for a browser session, including its configuration and status.
  - `id` string, uuid, required — Unique identifier for the session
  - `createdAt` string, date-time, required — Timestamp when the session started
  - `status` 'live' | 'released' | 'failed', required — Status of the session
  - `duration` integer, required — Duration of the session in milliseconds
  - `eventCount` integer, required — Number of events processed in the session
  - `timeout` integer, required — Session timeout duration in milliseconds
  - `dimensions` object, required — Viewport and browser window dimensions for the session
    - `width` integer, required — Width of the browser window
    - `height` integer, required — Height of the browser window
  - `creditsUsed` integer, required — Amount of credits consumed by the session
  - `websocketUrl` string, required — URL for the session's WebSocket connection
  - `debugUrl` string, required — URL for debugging the session
  - `sessionViewerUrl` string, required — URL to view session details
  - `userAgent` string — User agent string used in the session
  - `proxy` string — Proxy server used for the session
  - `proxyBytesUsed` integer, required — Amount of data transmitted through the proxy
  - `solveCaptcha` boolean — Indicates if captcha solving is enabled
  - `isSelenium` boolean — Indicates if Selenium is used in the session
  - `region` 'lax' | 'ord' | 'iad' | 'bom' | 'scl' | 'fra' | 'hkg' — The region where the session was created

## Other responses

- `400` — Default Response
- `404` — Default Response
- `500` — Default Response

## Changes

- **2025-05-28** `7fca3009423f` — 1 info
  - added the optional property `region` to the response with the `200` status

[Change 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/d5a9cdf80ea2/schema)