---
title: "Fetch cameras"
method: GET
path: "/cameras"
tags: ["Cameras"]
---

# Fetch cameras

`GET /cameras`

## Query parameters

- `ids` string
- `place_id` integer
- `lock_id` integer
- `sort` 'name' | '-name'

## Response `200`

OK

- union[]
  - union
    - object
      - `id` integer, required — The ID of the camera
      - `resource_type` 'Camera', required — The resource type of the camera
      - `name` string, required — The name of the camera
      - `description` string, nullable, required — The description of the camera
      - `created_at` string, date-time, required — When the camera was created
      - `updated_at` string, date-time, required — When the camera was updated
      - `metadata` object, required — The metadata for the camera. - Only basic types are allowed: string, null, integer, float, boolean. - Keys have a limit of 50 characters. - Values have a limit of 500 characters. - Keys number is limited to 50.
      - `enabled` boolean, required — Whether the camera is enabled or not. Only enabled cameras takes snapshots.
      - `clip_duration` integer, required — Duration in seconds of the video clip to take.
      - `number_of_snapshots` integer, required — The number of snapshots to fetch.
      - `remote_id` string, required — The remote id of the camera.
      - `snapshot_offset` integer, required — Offset in seconds of the clock of the camera if it has a drift from the API.
      - `supports_clips` boolean, required — Whether the camera supports clips.
      - `supports_images` boolean, required — Whether the camera supports images.
      - `supports_thumbnails` boolean, required — Whether the camera supports thumbnails.
      - `status` 'online' | 'offline', required — Whether the camera is online or offline.
      - `status_changed_at` string, date-time, nullable, required — When the camera connectivity status last changed.
      - `place_id` integer, required — The place ID of the camera
      - `lock_id` integer, nullable, required — The lock ID of the camera
      - `lock` object — The lock of the camera
        - `id` integer, required — The ID of the lock
        - `resource_type` 'Lock', required — The resource type of the lock
        - `name` string, required — The name of the lock
      - `type` 'rhombus_systems', required — The type of the camera.
      - `integration_id` integer, required — The integration ID of the camera
      - `integration` object, required — The integration of the camera
        - `id` integer, required — The ID of the integration
        - `resource_type` 'Integration', required — The resource type of the integration
        - `name` string, required — The name of the integration
        - `type` 'rhombus_systems_camera', required — The type of the integration.
    - object
      - `id` integer, required — The ID of the camera
      - `resource_type` 'Camera', required — The resource type of the camera
      - `name` string, required — The name of the camera
      - `description` string, nullable, required — The description of the camera
      - `created_at` string, date-time, required — When the camera was created
      - `updated_at` string, date-time, required — When the camera was updated
      - `metadata` object, required — The metadata for the camera. - Only basic types are allowed: string, null, integer, float, boolean. - Keys have a limit of 50 characters. - Values have a limit of 500 characters. - Keys number is limited to 50.
      - `enabled` boolean, required — Whether the camera is enabled or not. Only enabled cameras takes snapshots.
      - `clip_duration` integer, required — Duration in seconds of the video clip to take.
      - `number_of_snapshots` integer, required — The number of snapshots to fetch.
      - `remote_id` string, required — The remote id of the camera.
      - `snapshot_offset` integer, required — Offset in seconds of the clock of the camera if it has a drift from the API.
      - `supports_clips` boolean, required — Whether the camera supports clips.
      - `supports_images` boolean, required — Whether the camera supports images.
      - `supports_thumbnails` boolean, required — Whether the camera supports thumbnails.
      - `status` 'online' | 'offline', required — Whether the camera is online or offline.
      - `status_changed_at` string, date-time, nullable, required — When the camera connectivity status last changed.
      - `place_id` integer, required — The place ID of the camera
      - `lock_id` integer, nullable, required — The lock ID of the camera
      - `lock` object — The lock of the camera
        - `id` integer, required — The ID of the lock
        - `resource_type` 'Lock', required — The resource type of the lock
        - `name` string, required — The name of the lock
      - `type` 'generic', required — The type of the camera.

## Other responses

- `401` — Unauthorized

---

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