--- title: "Get Camera View Flags" method: GET path: "/camera-health/flags" tags: ["camera-health"] --- # Get Camera View Flags `GET /camera-health/flags` ## 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/camera-health/flags` - Auth: HTTP bearer Open and confirmed view flags, plus those cleared or resolved in the last 7 days, in the caller's Camera Health scope. ## Response `200` Successful Response - GetCameraViewFlagsResponse - `flags` CameraViewFlag[], required: Open and confirmed items, plus items cleared or resolved in the last 7 days, most recently raised first. - `id` string, uuid, required: Flag id. - `status` string, required: 'open' (needs a look), 'confirmed' (an operator agreed the view is blocked), 'cleared' (an operator judged it usable), or 'resolved' (two checks hours apart read clear after confirmation and customer notification). - `camera_id` string, uuid, required: Camera row id. - `camera_label` string, nullable: Operator-facing camera name. - `site_id` string, uuid, required: Site id. - `site_name` string, nullable: Site name. - `site_timezone` string, nullable: The site's IANA zone, for rendering times and the day/night split. - `parent_id` string, uuid, required: Client (parent) id. - `parent_name` string, nullable: Client company name. - `kind` string, nullable: The latest qualifying verdict's kind. - `coverage_pct` integer, nullable: The latest qualifying verdict's coverage, 0-100. - `reason` string, nullable: The latest qualifying verdict's explanation. - `opened_at` string, date-time, required: When the item opened. - `opened_kind` string, nullable: Immutable kind at opening; null for legacy items. - `opened_coverage_pct` integer, nullable: Immutable coverage at opening; null for legacy items. - `opened_reason` string, nullable: Immutable reason at opening; null for legacy items. - `opening_checks` CameraViewFlagCheck[]: The two opening verdicts, preserved after sample pruning. Images may expire. - `sample_id` string, uuid, nullable: The health sample this verdict was recorded on. Null only on a legacy opening verdict saved without it. - `received_at` string, date-time, nullable: When the server received the judged frame, frozen at claim time (view_frame_received_at). Ordering and the 7-day window use this, never the worker's capture clock. - `checked_at` string, date-time, required: When the AI verdict was recorded. - `captured_at` string, date-time, required: Worker clock at capture of the judged frame (display only; ordering uses the server's receipt time). - `light` string, required: 'day' when the frame arrived between 07:00 and 18:59 site-local time, else 'night'. Night haze and IR glare are the common false raises. - `obstructed` boolean, nullable: The model's verdict for this frame. - `kind` string, nullable: none, object, dirty_lens, web_or_insect, water_or_condensation, glare, out_of_focus, or other. - `coverage_pct` integer, nullable: Roughly how much of the frame is covered, 0-100. - `reason` string, nullable: The model's one-sentence explanation. - `snapshot_url` string, nullable: Presigned GET URL for the judged frame (1h). Null when the frame has no stored image or presigning failed. - `first_viewed_at` string, date-time, nullable: First actual item open by staff; list polling does not count. - `resolved_at` string, date-time, nullable: When two clear checks resolved a confirmed, notified item. - `last_raised_at` string, date-time, required: When a confirmed raise last refreshed it. - `raise_count` integer, required: Confirmed raises counted on this item (1 at opening). - `checks_obstructed` integer, required: View checks of this camera in the last 7 days that qualified (obstructed, not glare, coverage at or above view_obstructed_coverage_min). Rendered as 'N of M checks in the last 7 days'. - `checks_total` integer, required: All view checks of this camera in the last 7 days (the same set as checks, uncapped). - `day_snapshot_url` string, nullable: Presigned URL of the newest checked daylight frame (07:00-18:59 site-local), null if none in the last 7 days. - `night_snapshot_url` string, nullable: Presigned URL of the newest checked night frame, null if none in the last 7 days. - `checks` CameraViewFlagCheck[], required: Up to 24 newest checks of this camera in the last 7 days, newest first. - `sample_id` string, uuid, nullable: The health sample this verdict was recorded on. Null only on a legacy opening verdict saved without it. - `received_at` string, date-time, nullable: When the server received the judged frame, frozen at claim time (view_frame_received_at). Ordering and the 7-day window use this, never the worker's capture clock. - `checked_at` string, date-time, required: When the AI verdict was recorded. - `captured_at` string, date-time, required: Worker clock at capture of the judged frame (display only; ordering uses the server's receipt time). - `light` string, required: 'day' when the frame arrived between 07:00 and 18:59 site-local time, else 'night'. Night haze and IR glare are the common false raises. - `obstructed` boolean, nullable: The model's verdict for this frame. - `kind` string, nullable: none, object, dirty_lens, web_or_insect, water_or_condensation, glare, out_of_focus, or other. - `coverage_pct` integer, nullable: Roughly how much of the frame is covered, 0-100. - `reason` string, nullable: The model's one-sentence explanation. - `snapshot_url` string, nullable: Presigned GET URL for the judged frame (1h). Null when the frame has no stored image or presigning failed. - `recent_alarms` CameraViewFlagAlarm[], required: Up to 5 newest alarms on this camera since 24 hours before opened_at, newest first. - `event_id` string, uuid, required: Alarm (event) id. - `at` string, date-time, required: When the alarm was created. - `incident_type` string, nullable: The AI's incident type, null when no interpretation landed. - `outcome_label` string, required: History's outcome wording: the operator disposition label, 'Auto-dismissed' for the agent's dismissals, 'Expired' for one that aged out unreviewed, else 'Pending'. - `auto_dismissed` boolean, required: True when the agent dismissed it. - `confirmed_by_name` string, nullable: Who confirmed it. - `confirmed_at` string, date-time, nullable: When it was confirmed. - `notified_at` string, date-time, nullable: When the customer was last e-mailed about it. - `notified_by_name` string, nullable: Who sent that e-mail. - `notify_summary` string, nullable: What that send did. - `cleared_by_name` string, nullable: Who cleared it. - `cleared_at` string, date-time, nullable: When it was cleared. - `clear_reason` string, nullable: The operator's reason for clearing. - `quiet_until` string, date-time, nullable: After a clear: no new flag for this camera before this time unless coverage rises by view_flag_worse_by_pct. - `contacts` CameraViewFlagContact[], required: The site's contacts with an e-mail address (falling back to the client's primary contact), for seeding recipients. - `name` string, required: Contact name. - `role` string, nullable: The contact's role at the site; 'Primary contact' for the client fallback. - `email` string, required: A deliverable-looking address on file. - `counts` CameraViewFlagCounts, required - `open` integer, required: Open items in scope. - `confirmed` integer, required: Confirmed items in scope. --- [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/00252d8227c1?raw)