--- title: "List cameras" method: GET path: "/cameras/" tags: ["cameras"] --- # List cameras `GET /cameras/` This method retrieves the list of cameras. ## Query parameters - `active` boolean - `camera_groups` integer[] - `created_date_gt` string, date-time - `created_date_gte` string, date-time - `created_date_last_n_days` number - `created_date_lt` string, date-time - `created_date_lte` string, date-time - `created_date_nth_full_week` number - `created_date_nth_work_week` number - `external_detector` boolean - `external_vms` integer[] - `external_vms_camera_id_contains` string - `from_external_vms` boolean - `has_coordinates` boolean - `id_gte` integer - `id_in` integer[] - `latitude_gte` number, float - `latitude_lte` number, float - `limit` string - `longitude_gte` number, float - `longitude_lte` number, float - `name_contains` string - `object_type` string - `ordering` string - `page` string - `state_color` string ## Response `200` - PaginatedCameraList - `next_page` string, nullable - `prev_page` string, nullable - `results` Camera[] - `id` integer, required - `created_date` string, date-time, required — Object creation date - `modified_date` string, date-time, required — Object modification date - `group` integer, required — Camera group - `active` boolean — Processing is active - `name` string, required — Short name, up to 256 characters - `comment` string — Extended description, up to 2048 characters - `url` string - `router_url` string, nullable - `stream_settings` CameraStreamSettings — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers - `detectors` Detectors — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers - `face` DetectorParameters — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers - `filter_max_size` integer - `filter_min_quality` number, float - `filter_min_size` integer - `fullframe_crop_rot` boolean - `fullframe_use_png` boolean - `jpeg_quality` integer - `overall_only` boolean - `post_best_track_frame` boolean - `post_best_track_normalize` boolean - `post_first_track_frame` boolean - `post_last_track_frame` boolean - `realtime_post_every_interval` boolean - `realtime_post_first_immediately` boolean - `realtime_post_interval` number, float - `roi` string - `track_interpolate_bboxes` boolean - `track_max_duration_frames` integer - `track_miss_interval` integer - `track_overlap_threshold` number, float - `track_send_history` boolean - `tracker_type` string - `track_deep_sort_matching_threshold` number, float - `track_deep_sort_filter_unconfirmed_tracks` boolean - `filter_track_min_duration_frames` integer - `body` DetectorParameters — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers - `filter_max_size` integer - `filter_min_quality` number, float - `filter_min_size` integer - `fullframe_crop_rot` boolean - `fullframe_use_png` boolean - `jpeg_quality` integer - `overall_only` boolean - `post_best_track_frame` boolean - `post_best_track_normalize` boolean - `post_first_track_frame` boolean - `post_last_track_frame` boolean - `realtime_post_every_interval` boolean - `realtime_post_first_immediately` boolean - `realtime_post_interval` number, float - `roi` string - `track_interpolate_bboxes` boolean - `track_max_duration_frames` integer - `track_miss_interval` integer - `track_overlap_threshold` number, float - `track_send_history` boolean - `tracker_type` string - `track_deep_sort_matching_threshold` number, float - `track_deep_sort_filter_unconfirmed_tracks` boolean - `filter_track_min_duration_frames` integer - `car` DetectorParameters — Serializer mixin that raises ValidationError if excess fields are presented. Can be used in nested serializers - `filter_max_size` integer - `filter_min_quality` number, float - `filter_min_size` integer - `fullframe_crop_rot` boolean - `fullframe_use_png` boolean - `jpeg_quality` integer - `overall_only` boolean - `post_best_track_frame` boolean - `post_best_track_normalize` boolean - `post_first_track_frame` boolean - `post_last_track_frame` boolean - `realtime_post_every_interval` boolean - `realtime_post_first_immediately` boolean - `realtime_post_interval` number, float - `roi` string - `track_interpolate_bboxes` boolean - `track_max_duration_frames` integer - `track_miss_interval` integer - `track_overlap_threshold` number, float - `track_send_history` boolean - `tracker_type` string - `track_deep_sort_matching_threshold` number, float - `track_deep_sort_filter_unconfirmed_tracks` boolean - `filter_track_min_duration_frames` integer - `disable_drops` boolean - `ffmpeg_format` string - `ffmpeg_params` string[] - `imotion_threshold` number, float - `play_speed` number, float - `rot` string - `router_timeout_ms` integer - `router_verify_ssl` boolean - `start_stream_timestamp` integer - `stream_data_filter` string - `use_stream_timestamp` boolean - `video_transform` string - `enable_recorder` boolean - `enable_liveness` boolean - `record_audio` boolean - `use_rtsp_time` boolean - `vms_cleanup_settings` VmsCleanupSettings - `keep_event_before_after` integer, nullable — interval in `seconds` to be added to track - `cleanup_threshold` integer, nullable — cleanup threshold in `seconds` between tracks that will not be deleted - `cleanup_archive` boolean, nullable - `archive_cleanup_age` integer, nullable — delete video older than specified age - `between_tracks_cleanup_start_age` integer, nullable — delete video between track older than specified age - `cleanup_between_tracks` boolean, nullable - `keep_event_types` string[], nullable — tracks with event types to be deleted - `screenshot` string, uri, required — Screenshot URL - `health_status` Status, required - `enabled` boolean, required — `true` for the camera enabled through findface-video-manager - `status` string, required — Status code - `msg` string, required — Status description - `statistic` object, required — Various findface-video-worker statistics - `code` string, required — `Status` color code for UI. - `code_desc` string, required — `Status` description for UI. - `latitude` number, float, nullable — Camera latitude - `longitude` number, float, nullable — Camera longitude - `azimuth` number, float, nullable — Camera azimuth - `onvif_camera` integer, nullable — Related ONVIF camera object - `face_threshold` number, float, nullable — Camera face confidence threshold - `body_threshold` number, float, nullable — Camera body confidence threshold - `car_threshold` number, float, nullable — Camera car confidence threshold - `single_pass` boolean - `external_detector` boolean - `external_detector_token` string, required — Use this token for events creation API - `external_detector_settings` ExternalDetectorSettings — External detector filters - `filter_max_size` integer - `filter_min_size` integer - `filter_min_quality` number, float - `roi` object - `meta` object - `external_vms` integer, nullable — External VMS - `external_vms_camera_id` string, nullable — External VMS camera id - `frame_height` integer, required — Frame height in pixels - `frame_width` integer, required — Frame width in pixels - `angle_of_view` number, float, nullable — Angle of view of camera in degrees, used for maps - `pitch` number, float, nullable — Camera pitch, angle to horizon in degrees, used for maps - `address` string — Address, up to 2048 characters --- [API](https://skmtc.dev/ntechlab/apis/internal-api-documentation.md) · [All operations](https://skmtc.dev/ntechlab/apis/internal-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ntechlab/internal-api-documentation/revisions/fe217a895bc7/schema)