Sample - Slack Web API
GET/reactions.get

Get reactions for an item

Retrieves reactions for a message, file, or file comment. Supply the authentication token and identify the item with the applicable target parameters; set full to request the complete reaction list. The response identifies the item and includes its reactions.

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

6 parameters
tokenstringrequired
Authentication token with the `reactions:read` scope.
channelstringoptional
The channel where the message whose reactions you want to retrieve was posted.
filestringoptional
The identifier of the file whose reactions you want to retrieve.
file_commentstringoptional
The identifier of the file comment whose reactions you want to retrieve.
fullbooleanoptional
Set to true to always return the complete reaction list.
timestampstringoptional
The timestamp of the message whose reactions you want to retrieve.

2 status codes
200Returns the requested item and its reactions, identifying whether the item is a message, file, or file comment.
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:bad_timestampfile_not_foundfile_comment_not_foundmessage_not_foundno_item_specifiednot_authedinvalid_authaccount_inactiveno_permissioninvalid_array_arginvalid_charsetinvalid_form_data
okbooleanrequired
Allowed:false

Error handling

The token must grant the reactions:read scope. Identify the target with channel and timestamp, file, or file_comment; set full to true when you need the complete reaction list.