---
title: "Get all upcoming reminders"
method: GET
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/chat/upcoming-reminders"
tags: ["chat"]
---

# Get all upcoming reminders

`GET /ocs/v2.php/apps/spreed/api/{apiVersion}/chat/upcoming-reminders`

Required capability: `upcoming-reminders`

## Path parameters

- `apiVersion` 'v1', required

## Headers

- `OCS-APIRequest` boolean, required

## Response `200`

Reminders returned

- object
  - `ocs` object, required
    - `meta` OCSMeta, required
      - `status` string, required
      - `statuscode` integer, required
      - `message` string
      - `totalitems` string
      - `itemsperpage` string
    - `data` ChatReminderUpcoming[], required
      - `actorDisplayName` string, required — Display name of the message author
      - `actorId` string, required — Actor id of the message author
      - `actorType` string, required — Actor type of the message author
      - `message` string, required — Message string with placeholders
      - `messageId` integer, required — ID of the message the reminder is for
      - `messageParameters` object, required — Message parameters for `message` (see [Rich Object String](https://github.com/nextcloud/server/issues/1706))
      - `reminderTimestamp` integer, required — UNIX timestamp when the reminder should trigger
      - `roomToken` string, required — Conversation token

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