Reminders

List reminders

Retrieve all reminders for the authenticated user. Supports filtering, sorting, and cursor pagination. Returns `{ data: { reminders: [...], pagination?: { nextCursor, count } } }`.

GET /v2/reminders/

Parameters

Query parameters

take

integer

skip

integer

cursor

string (uuid)

where

object

orderBy

any

include

object

select

object

Responses

200 — Successful response

Content-Type: application/json

data

object required

data.reminders

array<object> required

data.reminders[].id

string (uuid) required

data.reminders[].user_id

string

data.reminders[].text

string | null

data.reminders[].due_at_date

string (date-time)

data.reminders[].due_at_time

string (date-time)

data.reminders[].is_complete

boolean

data.reminders[].email_sent

boolean

data.reminders[].push_notification_sent

boolean

data.reminders[].recurrence

string | null

data.reminders[].last_completed_at

string (date-time)

data.reminders[].next_occurrence_at

string (date-time)

data.reminders[].created_at

string (date-time)

data.reminders[].is_overdue

boolean

data.reminders[].next_cursor

string

data.reminders[].reminders_contacts

array<object>

data.reminders[].users

object | null

data.pagination

object

data.pagination.nextCursor

string | null

data.pagination.count

integer

Example

{
  "data": {
    "reminders": [
      {
        "id": "00000000-0000-0000-0000-000000000000"
      }
    ]
  }
}

400

No response body.

401

No response body.

403

No response body.

404

No response body.

409

No response body.

429

No response body.

500

No response body.

Code samples

curl https://api.prod.getdex.com/v2/reminders/ \
  --header 'Authorization: Bearer YOUR_API_KEY'

fetch('https://api.prod.getdex.com/v2/reminders/', {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY'
  }
})

requests.get(
    "https://api.prod.getdex.com/v2/reminders/",
    headers={
      "Authorization": "Bearer YOUR_API_KEY"
    }
)

Delete a reminder

Permanently delete a reminder by its ID. `Idempotency-Key` is optional on DELETE (the operation is HTTP-idempotent by semantics). Returns `{ data: { affected: 1, ids: [reminderId] } }`.

Create a reminder

Create a new reminder for the authenticated user. **Requires an `Idempotency-Key` header** — see Idempotency below. Returns `{ data: { reminder: {...} } }` with status 201.