---
title: "Get up to 10 rooms that have events in the next 7 days sorted by their start timestamp ascending"
method: GET
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/dashboard/events"
tags: ["calendar_integration"]
---

# Get up to 10 rooms that have events in the next 7 days sorted by their start timestamp ascending

`GET /ocs/v2.php/apps/spreed/api/{apiVersion}/dashboard/events`

Required capability: `dashboard-event-rooms`

## Path parameters

- `apiVersion` 'v4', required

## Headers

- `OCS-APIRequest` boolean, required

## Response `200`

A list of dashboard entries or an empty array

- object
  - `ocs` object, required
    - `meta` OCSMeta, required
      - `status` string, required
      - `statuscode` integer, required
      - `message` string
      - `totalitems` string
      - `itemsperpage` string
    - `data` DashboardEvent[], required
      - `calendars` DashboardEventCalendar[], required — List of calendars this event belongs to
        - `principalUri` string, required — Principal URI of the calendar owner
        - `calendarName` string, required — Name of the calendar
        - `calendarColor` string, nullable, required — Color of the calendar
      - `eventName` string, required — Name of the event
      - `eventDescription` string, nullable, required — Description of the event
      - `eventAttachments` object, required — Attachments of the event
      - `eventLink` string, required — Link to the event
      - `start` integer, required — UNIX timestamp of the event start
      - `end` integer, required — UNIX timestamp of the event end
      - `roomToken` string, required — Conversation token
      - `roomAvatarVersion` string, required — Version of conversation avatar for caching
      - `roomName` string, required — Name of the conversation
      - `roomDisplayName` string, required — Display name of the conversation
      - `roomType` integer, required — Type of the conversation (see [constants list](https://nextcloud-talk.readthedocs.io/en/latest/constants#conversation-types))
      - `roomActiveSince` integer, nullable, required — UNIX timestamp since when a call is active, or null if no call
      - `invited` integer, nullable, required — Number of invited attendees
      - `accepted` integer, nullable, required — Number of accepted attendees
      - `tentative` integer, nullable, required — Number of tentative attendees
      - `declined` integer, nullable, required — Number of declined attendees

## Other responses

- `401` — Current user is not logged in

---

[API](https://skmtc.dev/nextcloud/apis/spreed-full.md) · [All operations](https://skmtc.dev/nextcloud/apis/spreed-full/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nextcloud/spreed-full/revisions/41d6458d6d6e/schema)