---
title: "Get all Reminders"
method: GET
path: "/v2/reminders"
tags: ["Reminders"]
---

# Get all Reminders

`GET /v2/reminders`

Returns a page of Reminders visible to the caller.

You can filter reminders using the `filter` query parameter. The filter parameter is a string
that you can specify conditions based on the following properties.
| **Property Name** | **Type** | **Allowed Operators** | **Examples** |
|---|---|---|---|
| `id` | `int64` | `=` | `id=1\|id=2\|id=3` |
| `type` | `enum` | `=` | `type=one-time`, `type=recurring` |
| `status` | `enum` | `=` | `status=active`, `status=overdue`, `status=completed` |
| `resetTrigger` | `enum` | `=` | `resetTrigger=interaction`, `resetTrigger=email`, `resetTrigger=event` |
| `dueDate` | `datetime` | `>`, `<`, `>=`, `<=` | `dueDate>=2026-01-01T00:00:00Z` |
| `completedAt` | `datetime` | `>`, `<`, `>=`, `<=` | `completedAt=2026-01-01T00:00:00Z` |
| `createdAt` | `datetime` | `>`, `<`, `>=`, `<=` | `createdAt>=2026-01-01T00:00:00Z` |
| `updatedAt` | `datetime` | `>`, `<`, `>=`, `<=` | `updatedAt>=2026-01-01T00:00:00Z` |
| `owner.id` | `int64` | `=`, `!=` | `owner.id=1\|owner.id=2`, `owner.id!=3` |
| `creator.id` | `int64` | `=` | `creator.id=1` |
| `completer.id` | `int64` | `=` | `completer.id=1` |
| `company.id` | `int64` | `=` | `company.id=42` |
| `person.id` | `int64` | `=` | `person.id=42` |
| `opportunity.id` | `int64` | `=` | `opportunity.id=42` |

Results are ordered by `dueDate` ascending (soonest-due first).

## Query parameters

- `totalCount` boolean
- `cursor` string
- `limit` integer
- `filter` string

## Response `200`

OK

- RemindersReminderPaged — A page of Reminder objects.
  - `data` RemindersReminder[], required — A page of Reminder objects.
    - union — A reminder to follow up with a person, company, or opportunity. Discriminated by `type` — `one-time` reminders fire once on `dueDate`, and `recurring` reminders reset on a cadence.
      - RemindersOneTimeReminder — Shared fields common to both `OneTimeReminder` and `RecurringReminder`. Not used directly — callers receive one of the concrete variants discriminated by `type` on `Reminder`.
        - `id` integer, required — The reminder's unique identifier
        - `content` string, nullable, required — Free-form text attached to the reminder.
        - `dueDate` string, date-time, required — When the reminder is next due.
        - `creator` PersonReference, required
          - `id` integer, required — The persons's unique identifier
        - `owner` PersonReference, required
          - `id` integer, required — The persons's unique identifier
        - `completer` PersonReference, required
          - `id` integer, required — The persons's unique identifier
        - `company` CompanyReference, required
          - `id` integer, required — The company's unique identifier
        - `person` PersonReference, required
          - `id` integer, required — The persons's unique identifier
        - `opportunity` OpportunityReference, required
          - `id` integer, required — The opportunity's unique identifier
        - `createdAt` string, date-time, required — When the reminder was created.
        - `updatedAt` string, date-time, nullable, required — When the reminder was last updated. `null` if the reminder has never been updated.
      - RemindersRecurringReminder — Shared fields common to both `OneTimeReminder` and `RecurringReminder`. Not used directly — callers receive one of the concrete variants discriminated by `type` on `Reminder`.
        - `id` integer, required — The reminder's unique identifier
        - `content` string, nullable, required — Free-form text attached to the reminder.
        - `dueDate` string, date-time, required — When the reminder is next due.
        - `creator` PersonReference, required
          - `id` integer, required — The persons's unique identifier
        - `owner` PersonReference, required
          - `id` integer, required — The persons's unique identifier
        - `completer` PersonReference, required
          - `id` integer, required — The persons's unique identifier
        - `company` CompanyReference, required
          - `id` integer, required — The company's unique identifier
        - `person` PersonReference, required
          - `id` integer, required — The persons's unique identifier
        - `opportunity` OpportunityReference, required
          - `id` integer, required — The opportunity's unique identifier
        - `createdAt` string, date-time, required — When the reminder was created.
        - `updatedAt` string, date-time, nullable, required — When the reminder was last updated. `null` if the reminder has never been updated.
  - `pagination` PaginationWithTotalCount, required
    - `prevUrl` string, uri, nullable — URL for the previous page
    - `nextUrl` string, uri, nullable — URL for the next page

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `default` — Errors

---

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