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

# Get Fleet Band Detail

`GET /scheduling/fleet-bands/detail`

## 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/detail`
- Auth: HTTP bearer

The site list behind the band covering `at`.

404s when no band covers that instant - nothing monitored is not an empty
band, it is no band, and the week view never drew one there to click.

## Query parameters

- `at` string, date-time, required

## Response `200`

Successful Response

- GetFleetBandDetailResponse: The composition behind one band - what the band popover shows. Split from the list endpoint on purpose: a week can hold hundreds of bands and a book hundreds of sites, so embedding every band's site list would make the week view carry an order of magnitude more data than it renders.
  - `start` string, date-time, required: UTC instant the band begins.
  - `end` string, date-time, required: UTC instant the band ends.
  - `site_count` integer, required: Sites monitored during the band.
  - `camera_count` integer, required: Cameras monitored during the band.
  - `heightened_count` integer, required: Sites with at least one live heightened camera.
  - `operators` FleetBandOperatorModel[], required: Who is seated, and on which groups. Empty when operators_visible is false.
    - `operator_id` string, uuid, required: The seated operator.
    - `group_ids` string[], required: Coverage groups they are seated on during the band.
  - `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.
  - `center_timezone` string, nullable: Configured monitoring-center zone; null when unset.
  - `sites` FleetBandSiteModel[], required: Monitored sites in the band, grouped-ready (ordered by client then site). Sites with nothing live are omitted.
    - `site_id` string, uuid, required: The monitored site.
    - `site_name` string, nullable: Site display name.
    - `parent_id` string, uuid, nullable: The client this site belongs to.
    - `parent_name` string, nullable: Client display name.
    - `timezone` string, nullable: IANA zone this site's monitoring hours fire in.
    - `cameras_live` integer, required: Cameras monitored during the band.
    - `cameras_total` integer, required: Cameras the site has at all - lower live count means overrides are off.
    - `heightened` boolean, required: At least one live camera is in heightened mode.

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