Sample - Slack Web API
GET/reminders.list

List reminders

Lists all reminders created by or assigned to the authenticated user. Provide the authentication token when required by the authorization context. The response returns each reminder with its recipient, schedule, text, and completion information.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
tokenstringoptional
Authentication token with the `reminders:read` scope.

2 status codes
200Returns an array of reminder objects, each containing its identifier, creator, recipient, text, scheduled time, recurring status, and completion timestamp.
okbooleanrequired
Allowed:true
remindersarray<object>required
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:not_authedinvalid_authaccount_inactivetoken_revokedno_permissionorg_login_requireduser_is_botinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_datainvalid_post_type
okbooleanrequired
Allowed:false

Error handling

The token must grant the reminders:read scope when authentication is required. The authenticated user can retrieve only reminders available within that authorization context.