---
title: "Get Fleet Bands"
method: GET
path: "/scheduling/fleet-bands"
tags: ["scheduling"]
---

# Get Fleet Bands

`GET /scheduling/fleet-bands`

## 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/scheduling/fleet-bands`
- Auth: HTTP bearer

## Query parameters

- `start` string, date, required
- `end` string, date, required

## Response `200`

Successful Response

- GetFleetBandsResponse
  - `bands` FleetBandModel[], required: Bands in the requested window, ordered by start. Bands with nothing monitored are omitted; bands with sites and NO operators are KEPT - unattended coverage is the point of the view.
    - `start` string, date-time, required: UTC instant the band begins (inclusive).
    - `end` string, date-time, required: UTC instant the band ends (exclusive).
    - `site_count` integer, required: Sites with at least one camera being monitored during the band.
    - `camera_count` integer, required: Cameras being monitored during the band.
    - `heightened_count` integer, required: Sites with at least one live camera in heightened mode.
    - `operator_ids` string[], required: Operators seated across all coverage groups during the band. EMPTY for callers who may not see center staffing (see operators_visible) - and also genuinely empty when nobody is seated, which is the unattended-coverage case the view exists to surface.
  - `operator_names` object, required: operator_id -> display name. Empty when operators_visible is false.
  - `operators_visible` boolean, required: False for callers who may not see center staffing (site managers). Their counts are still computed over their own sites; only the operator identities are withheld, so the UI should hide the seat column rather than render 'nobody seated'.
  - `center_timezone` string, nullable: Configured monitoring-center zone; null when unset.

## 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)
