---
title: "List reminders"
method: GET
path: "/v1/reminders"
tags: ["Reminder"]
---

# List reminders

`GET /v1/reminders`

Retrieves a paginated list of reminders for the authenticated user with optional filtering by status.

## Query parameters

- `status` 'active' | 'paused' | 'completed' | 'cancelled'
- `page` integer
- `limit` integer

## Response `200`

List of reminders retrieved successfully

- ReminderList
  - `items` ReminderDto[]
    - `id` string
    - `user` string
    - `lastUpdate` integer
    - `created` integer
    - `title` string
    - `promptText` string
    - `deliveryTextTemplate` string
    - `scheduleType` string
    - `dtStart` integer
    - `timeZone` string
    - `rrule` string
    - `nextFireAt` integer
    - `status` string
    - `lastFiredAt` integer
  - `total` integer

## Other responses

- `401` — Not authorized to access reminders

---

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