---
title: "List User Events"
method: GET
path: "/team-messaging/v1/events"
tags: ["Calendar Events"]
---

# List User Events

`GET /team-messaging/v1/events`

Returns all calendar events created by the current user.

## Query parameters

- `recordCount` integer
- `pageToken` string

## Response `200`

OK

- TMEventList
  - `records` TMEventInfo[] — List of events created by the current user
    - `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
  - `navigation` TMNavigationInfo
    - `prevPageToken` string — Previous page token. To get previous page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens
    - `nextPageToken` string — Next page token. To get next page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens

---

[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)