Get Chat Message Reactions

Retrieve reaction data for a specific chat message (comment or reply).

Endpoint

GET /api/chat/:id/reactions

Authentication

Optional. When authenticated, the response includes the user's own reactions in myReactions.

Path Parameters

Parameter	Type	Description
id	integer	The chat message ID

Query Parameters

Parameter	Type	Required	Description
emoji	string	No	Filter to a specific emoji to get the list of users who reacted with that emoji

Response

Without emoji filter — Aggregated Counts

Status Code: 200 OK

Returns the total reaction counts per emoji and, if authenticated, the user's own reactions.

{
  "reactions": [
    { "emoji": "heart", "count": 12 },
    { "emoji": "fire", "count": 5 },
    { "emoji": "thumbs_up", "count": 3 }
  ],
  "myReactions": ["heart", "fire"]
}

Field	Type	Description
reactions	array	Array of { emoji, count } objects for each emoji used on this message
myReactions	string[]	Emoji identifiers the authenticated user has reacted with (empty if unauthenticated)

With emoji filter — Reactor Users

Status Code: 200 OK

Returns the list of users who reacted with the specified emoji.

{
  "emoji": "heart",
  "users": [
    {
      "id": 6604,
      "name": "Bruce van Zyl",
      "photoUrl": "1639671861952.png"
    },
    {
      "id": 6605,
      "name": "Jane Smith",
      "photoUrl": "1639672045123.png"
    }
  ]
}

Field	Type	Description
emoji	string	The emoji that was queried
users	array	Array of user objects (id, name, photoUrl) who reacted

Examples

Get aggregated counts

curl -X GET "https://api.tribesocial.io/api/chat/1693/reactions" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN"

Get users who reacted with a specific emoji

curl -X GET "https://api.tribesocial.io/api/chat/1693/reactions?emoji=heart" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN"