---
title: "List Sessions"
method: GET
path: "/sessions"
tags: ["sessions"]
---

# List Sessions

`GET /sessions`

## Query parameters

- `page` integer — Page number
- `page_size` integer — Number of items per page
- `only_active` boolean — Whether to only return active sessions
- `only_current_token` boolean — Whether to only return sessions for the current token (apikey)
- `include_system` boolean — Whether to include internal system sessions

## Headers

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

## Response `200`

Successful Response

- PaginatedResponseSessionResponse
  - `items` SessionResponse[], required
    - `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
  - `page` integer, required
  - `page_size` integer, required
  - `has_next` boolean, required
  - `has_previous` boolean, 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/revisions/246f6d21de0c/schema)