---
title: "Get active lock template"
method: GET
path: "/lkbx/templates/active"
tags: ["Lock Templates"]
---

# Get active lock template

`GET /lkbx/templates/active`

## Request

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

Returns the lock template used by the current active lock session. Returns null if no active lock.

## Response `200`

Active template or null

- ActiveLockTemplateResponse
  - `ok` true, required
  - `data` LockTemplate
    - `id` integer: Template ID
    - `ownerId` integer: Owner user ID
    - `name` string: Template name
    - `duration` integer: Lock duration in seconds
    - `isRandomDuration` boolean: Whether duration is randomized
    - `minDuration` integer, nullable: Minimum duration if random
    - `maxDuration` integer, nullable: Maximum duration if random
    - `isBreakEnabled` boolean: Whether breaks are allowed
    - `breakRegularity` integer: Break interval in seconds
    - `breakMaximum` integer: Maximum break duration
    - `breakPenalty` integer: Penalty for exceeding break
    - `breakKeyholderOnly` boolean: Only keyholder can grant breaks
    - `isDeepthroatEnabled` boolean: DTT integration enabled
    - `deepthroatTimeReduction` integer: Time reduction per DTT session
    - `isShameEnabled` boolean: Shame feature enabled
    - `shameTimeAdd` integer: Time added for shame
    - `isEmergencyUnlockEnabled` boolean: Emergency unlock available
    - `isPublic` boolean: Whether publicly accessible
    - `isPubliclyListed` boolean: Whether listed publicly
    - `isTestLock` boolean: Whether this is a test lock
    - `isTimeDisplayed` boolean: Whether remaining time is shown
    - `createdAt` string, date-time: Creation timestamp
  - `message` string: Message when no active lock

## Other responses

- `401`: Authentication required or token invalid
- `500`: Internal server error

## 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/templates/active/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)