Skip to content

list_smart_detections

List smart-detection events (person, vehicle, animal, package).

Side effects: None (read-only).

Filters Protect’s event stream to type == "smartDetectZone" and narrows to entries whose smartDetectTypes contain detection_type. Empty camera_id returns detections across all cameras.

list_smart_detections(detection_type="person", hours_back=12)
ParameterTypeRequiredDefaultDescription
detection_typestringno”person”One of "person", "vehicle", "animal", "package". Defaults to "person".
camera_idstringno""Protect camera id. Empty (default) returns matches across all cameras.
limitintegerno20Maximum number of events returned. Defaults to 20.
hours_backintegerno24Look-back window in hours. Defaults to 24.
controllerstringno”default”Name of the UniFi controller to target. Defaults to "default".