---
title: "Retrieve camera by ID"
method: GET
path: "/cameras/{id}/"
tags: ["cameras"]
---

# Retrieve camera by ID

`GET /cameras/{id}/`

This method retrieves a camera by its ID.

## Path parameters

- `id` integer, required

## Response `200`

- 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)
