Sign in
Calendar

Get 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.

get/calendars/group-busy-times

Query parameters

staff_group_idstring uuid required

The staff group ID to get busy times for

The staff group ID to get busy times for

start_datestring date required

Start date of the range (ISO format, e.g., '2025-10-15')

Start date of the range (ISO format, e.g., '2025-10-15')

end_datestring date required

End date of the range (ISO format, e.g., '2025-10-21')

End date of the range (ISO format, e.g., '2025-10-21')

Response

Successful Response

staff_group_idstring uuid required
start_datestring required
end_datestring required
timezonestring required

Changes

No recorded changes to this endpoint across all 2 revisions of this API.