---
title: "Get Group Busy Times"
method: GET
path: "/calendars/group-busy-times"
tags: ["Calendar"]
---

# Get Group Busy Times

`GET /calendars/group-busy-times`

Get busy time ranges for a staff group over a date range.

This endpoint returns time ranges when ALL members of the group are busy
(i.e., when no one is available to take a meeting). This is useful for
previewing group availability in a calendar view.

The endpoint reuses the same availability calculation logic as the live
call flow to ensure consistency.

- **staff_group_id**: The staff group ID to check
- **start_date**: Start date of the range (inclusive)
- **end_date**: End date of the range (inclusive)

Returns:
    List of busy time ranges with start and end datetimes, plus the display timezone.

## Query parameters

- `staff_group_id` string, uuid, required — The staff group ID to get busy times for
- `start_date` string, date, required — Start date of the range (ISO format, e.g., '2025-10-15')
- `end_date` string, date, required — End date of the range (ISO format, e.g., '2025-10-21')

## Response `200`

Successful Response

- GroupBusyTimesResponse — Response model for busy times for a staff group over a date range
  - `staff_group_id` string, uuid, required
  - `start_date` string, required
  - `end_date` string, required
  - `timezone` string, required
  - `busy_times` BusyTimeRange[], required
    - `start` string, required
    - `end` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)