---
title: "ReadTerminalSessions"
method: GET
path: "/v1/terminal-sessions/"
tags: ["terminal-session"]
---

# ReadTerminalSessions

`GET /v1/terminal-sessions/`

## Request

- Base URL: `https://localhost:1618/api`
- URL: `https://localhost:1618/api/v1/terminal-sessions/`
- Auth: API key in header `Authorization`

List terminal sessions visible to the operator. Normal accounts see their own sessions. Super-admins see every account and may filter with accountId.

## Query parameters

- `id` string
- `accountId` integer
- `pageNumber` integer
- `itemsPerPage` integer
- `sortBy` string
- `sortDirection` string

## Response `200`

OK

- DtoReadTerminalSessionsResponse
  - `pagination` TkDtoPagination
    - `itemsPerPage` integer
    - `itemsTotal` integer
    - `lastSeenId` string
    - `pageNumber` integer
    - `pagesTotal` integer
    - `sortBy` string
    - `sortDirection` string
  - `terminalSessions` EntityTerminalSession[]
    - `accountUsername` string
    - `attachedClients` integer
    - `command` string
    - `createdAt` integer
    - `id` string
    - `name` string
    - `workingDir` string

## Changes

- **2026-10-12** `1902a56749d0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/goinfinite/apis/osapi/changes/v1/terminal-sessions/get.md)

---

[API](https://skmtc.dev/goinfinite/apis/osapi.md) - [All operations](https://skmtc.dev/goinfinite/apis/osapi/llms.txt) - [OpenAPI document](https://skmtc.dev/goinfinite/apis/osapi/revisions/3147503ce764?raw)