---
title: "Get Coverage Groups"
method: GET
path: "/scheduling/coverage-groups"
tags: ["scheduling"]
---

# Get Coverage Groups

`GET /scheduling/coverage-groups`

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

## Response `200`

Successful Response

- GetCoverageGroupsResponse
  - `groups` CoverageGroupModel[], required: All coverage groups with their grants.
    - `id` string, uuid, required: The coverage group ID.
    - `name` string, required: Display name of the group.
    - `color` string, required: Display color used in schedule grids and chips.
    - `grants` CoverageGrantModel[], required: The parent/site grants that define the group's sites.
      - `id` string, uuid, required: The grant ID.
      - `parent_id` string, uuid, nullable: Parent granted wholesale - covers every current AND future site under it (null for site grants).
      - `site_id` string, uuid, nullable: Individually granted site (null for parent grants).
    - `site_count` integer, required: Distinct sites currently covered (parent grants expanded).
    - `members` CoverageGroupMemberModel[]: Operators who are standing members of this group. Their tenant scope includes this group's sites -- SCOPE ONLY, never a permission. Deleting a group with members is refused (409).
      - `id` string, uuid, required: The operator ID.
      - `first_name` string, required: Member's first name.
      - `last_name` string, required: Member's last name.
      - `role` 'owner' | 'operator' | 'site_manager' | 'read_only' | 'account_manager' | 'monitoring_manager' | 'location_manager' | 'support', required
    - `member_count` integer: How many operators are standing members of this group.
  - `ungrouped_site_count` integer, required: Sites not covered by any group - alerts from them have no scheduled owner.

---

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