protect_get_sensor
Read-only
Retrieve complete details for a UniFi Protect sensor by ID, including battery status, motion, temperature, humidity, light, leak, and tampering state. Returns all settings and event timestamps in one response.
Instructions
Get full details for a specific sensor by ID. Returns: id, modelKey, name, mac, state, mountType, batteryStatus (percentage, isLow), stats (light, humidity, temperature), lightSettings, humiditySettings, temperatureSettings, isOpened, openStatusChangedAt, isMotionDetected, motionDetectedAt, motionSettings, glassBreakSettings, scheduleMode, armProfileIds, hasCustomSensitivityWhenArmed, alarmTriggeredAt, alarmSettings, leakDetectedAt, externalLeakDetectedAt, leakSettings, tamperingDetectedAt, wirelessConnectionState (7.1.83 docs).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Sensor ID |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Device ID | |
| mac | No | MAC address | |
| name | No | Device name | |
| state | No | CONNECTED | DISCONNECTED | ... | |
| stats | No | Environmental stats (object: light, humidity, temperature) | |
| isOpened | No | Open/close contact state (boolean) | |
| modelKey | No | Resource kind | |
| mountType | No | Mount type, e.g. "door", "leak", "garage" | |
| leakSettings | No | Leak detection settings (object) | |
| scheduleMode | No | Schedule mode: "always" | "when_armed" | |
| alarmSettings | No | Alarm settings (object: isEnabled) | |
| armProfileIds | No | Arm profile IDs this sensor belongs to (array of strings) | |
| batteryStatus | No | Battery status (object: percentage, isLow) | |
| lightSettings | No | Light threshold settings (object) | |
| leakDetectedAt | No | Last leak timestamp in epoch ms (number) | |
| motionSettings | No | Motion detection settings (object) | |
| alarmTriggeredAt | No | Last alarm timestamp in epoch ms (number) | |
| humiditySettings | No | Humidity threshold settings (object) | |
| isMotionDetected | No | Motion currently detected (boolean) | |
| motionDetectedAt | No | Last motion timestamp in epoch ms (number) | |
| glassBreakSettings | No | Glass-break detection settings (object) | |
| openStatusChangedAt | No | Open-status change timestamp in epoch ms (number) | |
| tamperingDetectedAt | No | Last tampering timestamp in epoch ms (number) | |
| temperatureSettings | No | Temperature threshold settings (object) | |
| externalLeakDetectedAt | No | Last external-leak timestamp in epoch ms (number) | |
| wirelessConnectionState | No | Wireless link state (object: signalState, batteryStatus, bridge) | |
| hasCustomSensitivityWhenArmed | No | Custom armed sensitivity enabled (boolean) |