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

# Get Group Busy Times

`GET /calendars/group-busy-times`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/calendars/group-busy-times`
- Auth: none declared

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/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)