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

# List NVRs

`GET /v1/nvrs`

List all NVRs accessible to the user.

Retrieve NVRs accessible to the user with their current status and
configuration details. Results can be filtered by NVR UUID or location.

## Query parameters

- `nvr` string
- `location_id` integer
- `page` integer
- `limit` integer

## Response `200`

Successful Response

- NVRList — Paginated list of NVRs.
  - `results` NVR[], required — List of NVRs
    - `name` string, required — NVR display name
    - `location` Location — A physical location where cameras and NVRs are installed.
      - `id` integer, required — Unique location identifier
      - `name` string, required — Location display name
      - `address` string, required — Physical street address
      - `timezone` string — Timezone (IANA format, e.g., 'America/New_York')
    - `camera_info` CameraInfo, required — Camera capacity and status summary for the NVR.
      - `num_cameras_enabled` integer, required — Number of enabled cameras
      - `num_cameras_disabled` integer, required — Number of disabled cameras
      - `num_available_cameras_slots` integer, required — Number of available camera slots
      - `max_cameras_slots` integer, required — Maximum camera slots supported
      - `num_online_cameras` integer, required — Number of currently online cameras
    - `retention_days` integer, required — Video retention period in days
    - `internet_status` InternetStatus — Internet connectivity status and speed information.
      - `domain` string, required — Domain/IP that was pinged
      - `avg_ping_latency_ms` number — Average ping latency in milliseconds
      - `packet_loss` number — Packet loss percentage (0-100)
      - `internet_speed` InternetSpeed — Internet speed test results.
        - `download_speed_bps` number, required — Download speed in bits per second
        - `upload_speed_bps` number, required — Upload speed in bits per second
        - `timestamp` string, required — Timestamp of speed test result (ISO 8601 format)
    - `serial_number` string — NVR serial number
    - `network_info` NetworkInfo — Network configuration of the NVR.
      - `ip_address` string — NVR IP address on the local network
      - `subnet_mask` string — Network subnet mask
      - `gateway` string — Default gateway IP address
    - `status` Status, required — Current connectivity status of the NVR.
      - `last_seen_time` string — Last connection timestamp (ISO 8601 format)
      - `is_online` boolean, required — Whether the NVR is currently connected
    - `sku` string — Stock Keeping Unit (SKU) identifier for the NVR hardware model
  - `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)