---
title: "List session history records"
method: GET
path: "/v2/system-logs/session-history"
tags: ["Session History"]
---

# List session history records

`GET /v2/system-logs/session-history`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/v2/system-logs/session-history`
- Auth: API key in header `OAuth`

List session history records.

## Query parameters

- `startTime` string, date-time
- `endTime` string, date-time
- `userId` string
- `action` string
- `recordType` string
- `cursor` string
- `limit` integer

## Response `200`

A successful response.

- SessionHistoryListResponse
  - `success` boolean
  - `data` ModelSessionHistoryRecord[]
    - `userId` string, int64
    - `actionTime` string, date-time
    - `desc` string
    - `url` string
    - `action` string
    - `recordType` string
    - `recordId` string
    - `sessionInfo` ModelSessionInfo
      - `sessionId` string
      - `ip` string
      - `host` string
      - `agent` string
      - `sessionStart` string, date-time
      - `loginViaPortal` boolean
    - `ksuid` string
  - `nextCursor` string

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)