---
title: "Get lockbox device by ID"
method: GET
path: "/lkbx/{id}"
tags: ["LKBX"]
---

# Get lockbox device by ID

`GET /lkbx/{id}`

Returns detailed information about a specific Chastity Lockbox device.

## Path parameters

- `id` integer, required

## Response `200`

Lockbox device details

- LkbxDeviceDetailResponse
  - `ok` true, 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

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required or token invalid
- `404` — Lockbox device not found

---

[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)