---
title: "List lock sessions"
method: GET
path: "/lkbx/session"
tags: ["Lock Sessions"]
---

# List lock sessions

`GET /lkbx/session`

Returns a summary list of all lock sessions you have access to (past and present). Includes sessions owned by linked users — e.g. a lockee you keyhold for — alongside your own; use `ownerId` to distinguish owners.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

List of lock sessions

- LockSessionListResponse
  - `ok` true, required
  - `data` object, required
    - `data` LockSessionSummary[], required
      - `id` integer — Session ID
      - `bubbleId` string — Unique public identifier
      - `publicId` string — Public session ID
      - `ownerId` integer — Owner user ID
      - `name` string — Session name
      - `lockState` 'pending' | 'locked' | 'completed' | 'abandoned' | 'break' — Current lock state
      - `duration` integer — Lock duration in seconds
      - `startDate` string, date-time, nullable — Session start time
      - `endDate` string, date-time, nullable — Session end time
      - `isActive` boolean — Whether session is active
      - `createdAt` string, date-time — Creation timestamp
      - `keyholderIds` integer[] — IDs of the users assigned as keyholders for this session. An empty array means a self-lock (no keyholder). Resolve IDs to usernames via the Users endpoints.
    - `pagination` Pagination, required
      - `limit` integer, required — Number of records returned
      - `offset` integer, required — Number of records skipped

## Other responses

- `401` — Authentication required or token invalid
- `500` — Internal server error

---

[API](https://skmtc.net/researchanddesire/apis/research-and-desire-api.md) · [All operations](https://skmtc.net/researchanddesire/apis/research-and-desire-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/researchanddesire/research-and-desire-api/versions/9c6dc82bb579/schema)