---
title: "Get upcoming meetings by group"
method: GET
path: "/groups/{groupKey}/upcomingMeetings"
tags: ["Groups"]
---

# Get upcoming meetings by group

`GET /groups/{groupKey}/upcomingMeetings`

Get upcoming meetings for a specified group. This API call is only available to users with the admin role. This API call can be used only for groups with maximum 50 organizers.

## Path parameters

- `groupKey` integer, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- UpcomingMeetingByGroup[]
  - `accountKey` string, required — The key of the company account
  - `email` string, required — The meeting organizer's email address
  - `endTime` string, date-time, required — The time the meeting instance ended
  - `firstName` string, required — The meeting organizer's first name
  - `groupName` string, required — The name of the group the meeting belongs to
  - `lastName` string, required — The surname of the meeting organizer
  - `locale` string, required — The current language setting of the organizer in the web portal
  - `meetingId` string, required — The meeting ID
  - `meetingType` 'immediate' | 'recurring' | 'scheduled', required — The meeting type
  - `organizerKey` string, required — The key of the meeting organizer
  - `passwordRequired` boolean, required — Indicates whether a password is required to join the meeting or not
  - `startTime` string, date-time, required — The time the meeting instance will start
  - `status` 'ACTIVE' | 'INACTIVE' — The meeting status, i.e whether the meeting is running or not
  - `subject` string, required — The subject of the meeting

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/citrixonline/apis/gotomeeting.md) · [All operations](https://skmtc.net/citrixonline/apis/gotomeeting/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrixonline/gotomeeting/versions/b78f66fb68da/schema)