Skip to content

list_recordings

List Protect recordings for one camera over the last hours_back hours.

Side effects: None (read-only).

Returns one record per stored clip segment with id, start, end, type, and size (bytes). Useful for finding the recording window around a specific motion event.

list_recordings(camera_id="65f...", hours_back=6)
ParameterTypeRequiredDefaultDescription
camera_idstringyesProtect camera id.
hours_backintegerno24Look-back window in hours. Defaults to 24.
controllerstringno”default”Name of the UniFi controller to target. Defaults to "default".