---
title: "List cameras"
method: GET
path: "/v1/cameras"
tags: ["cameras"]
---

# List cameras

`GET /v1/cameras`

List all cameras accessible to the user.

Retrieve cameras accessible to the user with their current status and
configuration details. Results can be filtered by NVR, location,
MAC address, IP address, or camera group ID.

## Query parameters

- `nvrs` string[]
- `location_ids` integer[]
- `exclude_disabled` boolean
- `mac_addresses` string[]
- `ips` string[]
- `group_ids` integer[]
- `page` integer
- `limit` integer

## Response `200`

Successful Response

- CameraList — Paginated list of cameras.
  - `results` Camera[], required — List of cameras
    - `id` integer, required — Unique camera identifier
    - `mac_address` string, required — Camera MAC address
    - `name` string, required — Camera display name
    - `ip` string, required — Camera IP address on the local network
    - `vendor` string, required — Camera manufacturer/brand
    - `manufacturer` string — Camera hardware manufacturer
    - `model` string — Camera hardware model
    - `is_enabled` boolean, required — Whether the camera is enabled for recording
    - `status` CameraStatus, required — Current connectivity status of a camera.
      - `is_online` boolean, required — Indicates whether the camera is currently connected and accessible
      - `last_seen_time` string — Last connection timestamp (ISO 8601 format)
    - `nvr` CameraNVRInfo, required — NVR (Network Video Recorder) associated with the camera.
      - `name` string, required — NVR display name
      - `timezone` string — NVR timezone (IANA format, e.g., 'America/New_York')
    - `rtsp_port` integer, required — RTSP streaming port number
    - `width` integer — Video resolution width in pixels
    - `height` integer — Video resolution height in pixels
    - `fps` integer — Video frames per second
    - `codec` string — Video codec (e.g., 'H264', 'H265')
    - `onvif_enabled` boolean, required — Whether ONVIF protocol is enabled
    - `video_orientation_type` string, required — Video orientation (e.g., 'normal', 'rotated_180')
    - `feature_flags` FeatureFlags, required — Current feature flag settings for a camera.
      - `is_audio_enabled` boolean, required — Whether audio recording is enabled
      - `is_license_plate_detection_enabled` boolean, required — Whether license plate detection is enabled
      - `is_force_fps_enabled` boolean, required — Whether FPS is forced to a specific value
      - `auto_tracking` boolean, required — Whether PTZ auto-tracking is enabled
    - `camera_groups` CameraGroup[], required — Groups this camera belongs to
      - `id` integer, required — Unique camera group identifier
      - `name` string, required — Camera group display name
    - `location` CameraLocation — Location associated with cameras and camera groups.
      - `id` integer, required — Unique location identifier
      - `name` string, required — Location display name
      - `timezone` string, required — IANA timezone (e.g., 'America/New_York')
  - `has_more` boolean, required — True if additional pages are available

## Other responses

- `422` — Validation error

---

[API](https://skmtc.dev/coram/apis/coram-api.md) · [All operations](https://skmtc.dev/coram/apis/coram-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coram/coram-api/revisions/2842f226f93b/schema)