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

# List available sessions

`GET /api/sessions`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Authorization`
  - API key in query parameter `token`

## Response `200`

List of current sessions

- Session[]
  - `id` string, uuid
  - `path` string: path to the session
  - `name` string: name of the session
  - `type` string: session type
  - `kernel` Kernel: Kernel information
    - `id` string, uuid, required: uuid of kernel
    - `name` string, required: kernel spec name
    - `last_activity` string: ISO 8601 timestamp for the last-seen activity on this kernel. Use this in combination with execution_state == 'idle' to identify which kernels have been idle since a given time. Timestamps will be UTC, indicated 'Z' suffix. Added in notebook server 5.0.
    - `connections` number: The number of active connections to this kernel.
    - `execution_state` string: Current execution state of the kernel (typically 'idle' or 'busy', but may be other values, such as 'starting'). Added in notebook server 5.0.

## Other responses

- `403`: This method is not accessible when the kernel gateway when the `list_kernels` option is `False`.

---

[API](https://skmtc.dev/jupyter-server/apis/jupyter-enterprise-gateway-api.md) - [All operations](https://skmtc.dev/jupyter-server/apis/jupyter-enterprise-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jupyter-server/apis/jupyter-enterprise-gateway-api/revisions/15b16ff20d45?raw)