Lock Sessions

List lock sessions

Report an API docs issue

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.

GET
/
lkbx
/
session

Autorisations

Authorizationstringheaderrequired

API tokens can be created in the Dashboard settings. Requires an Ultra subscription.

Paramètres de requête

limitintegerquery

Number of records to return (default 50, max 100)

Required range: 1 ≤ x ≤ 100

Default: 50

Example: 50

offsetintegerquery

Number of records to skip (default 0)

Required range: x ≥ 0

Default: 0

Example: 0

Réponse

200application/json

List of lock sessions

okbooleanrequired
dataobjectrequired
Show child attributes
dataobject[]required
Show child attributes
idinteger

Session ID

bubbleIdstring

Unique public identifier

publicIdstring

Public session ID

ownerIdinteger

Owner user ID

namestring

Session name

lockStateenum

Current lock state

Allowed values: pendinglockedcompletedabandonedbreak

durationinteger

Lock duration in seconds

startDatestring<date-time> | null

Session start time

endDatestring<date-time> | null

Session end time

isActiveboolean

Whether session is active

createdAtstring<date-time>

Creation timestamp

keyholderIdsinteger[]

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.

paginationobjectrequired
Show child attributes
limitintegerrequired

Number of records returned

Example: 50

offsetintegerrequired

Number of records skipped

Example: 0

401application/json

Authentication required or token invalid

okbooleanrequired
errorstringrequired
500application/json

Internal server error

okbooleanrequired
errorstringrequired