---
title: "Session Status"
method: GET
path: "/sessions/{session_id}"
tags: ["sessions"]
---

# Session Status

`GET /sessions/{session_id}`

## Path parameters

- `session_id` string, required

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Response `200`

Successful Response

- SessionResponse
  - `session_id` string, required — The ID of the session (created or existing). Use this ID to interact with the session for the next operation.
  - `idle_timeout_minutes` integer, required — Session idle timeout in minutes. Will timeout if now() > last access time + idle_timeout_minutes
  - `max_duration_minutes` integer — Session max duration in minutes. Will timeout if now() > creation time + max_duration_minutes
  - `created_at` string, date-time, required — Session creation time
  - `closed_at` string, date-time, nullable — Session closing time
  - `last_accessed_at` string, date-time, required — Last access time
  - `duration` string — Session duration
  - `status` 'active' | 'closed' | 'error' | 'timed_out', required — Session status
  - `steps` object[] — Steps of the session
  - `error` string, nullable — Error message if the operation failed to complete
  - `proxies` boolean — Whether proxies were used for the session. True if any proxy was applied during session creation.
  - `browser_type` 'chromium' | 'chrome' | 'firefox' | 'chrome-nightly' | 'chrome-turbo'
  - `use_file_storage` boolean — Whether FileStorage was attached to the session.
  - `network_request_bytes` integer — Total byte usage for network requests.
  - `network_response_bytes` integer — Total byte usage for network responses.
  - `user_agent` string, nullable — The user agent to use for the session
  - `viewport_width` integer, nullable — The width of the viewport
  - `viewport_height` integer, nullable — The height of the viewport
  - `headless` boolean — Whether to run the session in headless mode.
  - `solve_captchas` boolean, nullable — Whether to solve captchas.
  - `cdp_url` string, nullable — The URL to connect to the CDP server.
  - `viewer_url` string, nullable — The remote session viewer URL.
  - `web_bot_auth` boolean — Whether to use web bot authentication.
  - `auth_ids` string[] — Managed Auth connection IDs attached to this session.
  - `system_hidden` boolean — Whether this session is an internal system run. Internal system runs are omitted from session.list() unless include_system=True is requested.
  - `timeout_minutes` integer, required

## Other responses

- `422` — Validation Error

---

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