Skip to main content
GET
/
api
/
reminders
List reminders created by the current user
curl --request GET \
  --url https://your-instance.example.com/api/reminders \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "_id": "65f0a0b0c0d0e0f0a0b0c0d0",
      "contactId": "65c2d0e0f0a0b0c0d0e0f0a0",
      "organizationId": "65a0e0e0e0e0e0e0e0e0e0e0",
      "createdBy": "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"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
contactId
string
​
contactIds
string

Comma-separated list of contact ids

Response

Reminders returned

​
success
enum<boolean>
required
Available options:
true
​
data
object[]
required