---
title: "List Group Events"
method: GET
path: "/team-messaging/v1/groups/{groupId}/events"
tags: ["Calendar Events"]
---

# List Group Events

`GET /team-messaging/v1/groups/{groupId}/events`

Returns a list of calendar events available for the current user within the specified group. Users can only see their personal tasks and public tasks.

## Path parameters

- `groupId` string, required

## Response `200`

OK

- TMEventInfo
  - `id` string — Internal identifier of an event
  - `creatorId` string — Internal identifier of a person created an event
  - `title` string — Event title
  - `startTime` string, date-time — Datetime of starting an event
  - `endTime` string, date-time — Datetime of ending an event
  - `allDay` boolean — Indicates whether an event has some specific time slot or lasts for the whole day(s)
  - `recurrence` EventRecurrenceInfo
    - `schedule` 'None' | 'Day' | 'Weekday' | 'Week' | 'Month' | 'Year' — Event recurrence settings. For non-periodic events the value is `None`. Must be greater or equal to event duration: 1- Day/Weekday; 7 - Week; 28 - Month; 365 - Year
    - `endingCondition` 'None' | 'Count' | 'Date' — Condition of ending an event
    - `endingAfter` integer — Count of event iterations. For periodic events only. Value range is 1 - 10. Must be specified if `endingCondition` is `Count`
    - `endingOn` string, date-time — Iterations ending datetime for periodic events in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format
  - `color` 'Black' | 'Red' | 'Orange' | 'Yellow' | 'Green' | 'Blue' | 'Purple' | 'Magenta' — Color of Event title (including its presentation in Calendar)
  - `location` string — Event location
  - `description` string — Event details

## Other responses

- `404` — Group with specified Id is not found.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)