---
title: "Get Cameras Health"
method: GET
path: "/cameras/health"
tags: ["cameras"]
---

# Get Cameras Health

`GET /cameras/health`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/cameras/health`
- Auth: HTTP bearer

## Query parameters

- `site_id` string, uuid, nullable: Only cameras at this site
- `parent_id` string, uuid, nullable: Only cameras of this client (parent)

## Response `200`

Successful Response

- GetCamerasHealthResponse
  - `cameras` GetCameraHealthResponse[], required: Health of every non-retired camera the caller may see (optionally narrowed by site_id / parent_id). Each entry is exactly what GET /cameras/{camera_id}/health returns for that camera.
    - `id` string, uuid, required: Camera UUID
    - `healthy` boolean, required: Whether the camera is healthy based on the last heartbeat within the threshold
    - `last_healthcheck_at` string, date-time, nullable: Timestamp (UTC) of the last health check, if any
  - `stale_after_seconds` integer, required: A camera whose last ingestor health report is older than this reads healthy=false regardless of the flag it last reported.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verdun/apis/verdun-api.md) - [All operations](https://skmtc.dev/verdun/apis/verdun-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verdun/apis/verdun-api/revisions/35a2a6ebedda?raw)