RAD Developer Docs
Lock Sessions

List lock sessions

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

Authorizations

Authorizationstringheaderrequired

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

Query Parameters

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

Response

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