List reminders for the current user or for one record

Server URLloading...

GET

/api/reminders

Send

Authorization

Query

Returns reminders scoped to the caller's organization, sorted by reminderDate ascending.

scope=mine (the default) is the caller's personal list: only reminders with assigneeId = userId. Unassigned reminders belong to no personal list and are not returned.

scope=record returns every reminder attached to the requested record whatever its assignee, for the per-contact / per-application / per-conversation surfaces; it requires at least one of contactId, contactIds, applicationId or conversationId. Reminders the caller does not own are readable but cannot be updated or deleted.

Filters combine (AND). status selects unfired (pending, the default), fired, or both.

Query Parameters

Response Body

curl -X GET "https://example.com/api/reminders"

{  "success": true,  "data": [    {      "_id": "65f0a0b0c0d0e0f0a0b0c0d0",      "contactId": "65c2d0e0f0a0b0c0d0e0f0a0",      "organizationId": "65a0e0e0e0e0e0e0e0e0e0e0",      "createdBy": "65b1f0a2c3d4e5f6a7b8c9d0",      "assigneeId": "65b1f0a2c3d4e5f6a7b8c9d0",      "note": "Follow up on demo booking",      "reminderDate": "2026-05-22T15:00:00.000Z",      "channelType": "sms",      "fired": false,      "createdAt": "2026-05-18T12:00:00.000Z",      "updatedAt": "2026-05-18T12:00:00.000Z"    }  ]}