Skip to main content
GET
Search Reminders
A Reminder defines an automated message triggered by a specific event or schedule. Reminders can send emails, canned messages, or surveys based on triggers such as sign-up anniversaries, booking activity, invoice due dates, or contract milestones.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the Reminder-List role.

Enums

Query Parameters

Pagination & Sorting

integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g. Name, CreatedOn).
integer
Sort direction. 0 for ascending, 1 for descending.

Filters

integer
Filter by iD of the business linked to this record.
string
Filter by display name of the linked business (read-only).
string
Filter by the name value for this reminder.
boolean
Filter by whether for all contacts is enabled.
boolean
Filter by whether for all members is enabled.
boolean
Filter by whether for all child locations is enabled.
integer
Filter by iD of the coworker linked to this record.
integer
Filter by the reminder type value for this reminder.
string
Filter by date/time value for reminder date.
integer
Filter by the days after signup value for this reminder.
integer
Filter by iD of the product linked to this record.
string
Filter by display name of the linked product (read-only).
integer
Filter by iD of the survey linked to this record.
string
Filter by display name of the linked survey (read-only).
integer
Filter by the days after renewal value for this reminder.
integer
Filter by the days before renewal value for this reminder.
integer
Filter by the reminder action value for this reminder.
string
Filter by the email value for this reminder.
integer
Filter by iD of the canned response linked to this record.
string
Filter by display name of the linked canned response (read-only).
string
Filter by date/time value for next process time.
boolean
Filter by whether only send to team paying members is enabled.
boolean
Filter by whether only send to active coworkers is enabled.
integer
Filter by the blocking period minutes value for this reminder.

Range Filters

string
Filter by date/time value for reminder date greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date/time value for reminder date less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
integer
Filter by the days after signup value for this reminder greater than or equal to this value.
integer
Filter by the days after signup value for this reminder less than or equal to this value.
integer
Filter by the days after renewal value for this reminder greater than or equal to this value.
integer
Filter by the days after renewal value for this reminder less than or equal to this value.
integer
Filter by the days before renewal value for this reminder greater than or equal to this value.
integer
Filter by the days before renewal value for this reminder less than or equal to this value.
string
Filter by date/time value for next process time greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date/time value for next process time less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
integer
Filter by the blocking period minutes value for this reminder greater than or equal to this value.
integer
Filter by the blocking period minutes value for this reminder less than or equal to this value.
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

Reminder[]
The list of Reminder records matching the query. See the Get one Reminder endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each Reminder. The following fields are not populated in the Records[] response: CoworkerId, ReminderDate, DaysAfterSignup, ProductId, SurveyId, DaysAfterRenewal, DaysBeforeRenewal, Email, CannedResponseId, BlockingPeriodMinutes.To get all fields, fetch the full record using the Get one Reminder endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (0 = ascending, 1 = descending).
integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response