---
title: "List lockbox devices"
method: GET
path: "/lkbx"
tags: ["LKBX"]
---

# List lockbox devices

`GET /lkbx`

Returns all Chastity Lockbox devices registered to your account, ordered by most recently visited.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

List of lockbox devices

- LkbxDeviceListResponse
  - `ok` true, required
  - `data` object, required
    - `data` LkbxDevice[], required
      - `id` integer — Device ID
      - `bubbleId` string — Unique public identifier
      - `macAddress` string — Device MAC address
      - `ownerId` integer — Owner user ID
      - `locked` boolean — Current lock state
      - `hueShift` integer — LED color hue shift
      - `lastVisited` string, date-time — Last connection time
      - `lastLogAt` string, date-time — Last log entry time
    - `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)