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

# Get lockbox device by ID

`GET /lkbx/{id}`

## Request

- Base URL: `https://dashboard.researchanddesire.com/api/v1`
- URL: `https://dashboard.researchanddesire.com/api/v1/lkbx/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token` scopes: `lkbx:read`

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: True while this device has an active lock session whose lockState is "locked". False during a break (including break_pending and break_ending, when the box is open), before the box has closed, and when there is no active session. Derived from the active session; for the full state use GET /lkbx/session/current.
    - `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

## Changes

- **2026-09-22** `2411203b3c10`: 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `oauth2` was added to the API

[Operation history](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/changes/lkbx/:id/get.md)

---

[API](https://skmtc.dev/researchanddesire/apis/research-and-desire-api.md) - [All operations](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/revisions/682fc4d7f6d5?raw)