Get Group Counters

HTTP MethodURLRequires Auth

GET

/api/v1/groups.counters

Query Parameters

Only one of roomId or roomName is required.

KeyExampleDescription

roomId*

euzoT67Gx6nXcn66M

The group's ID.

roomName*

channel.cf.1518990680083

The group's name.

userId

RtycPC29hqLJfT9xj

Counters for provided user ID (need to have a view-room-administration right for calling user).

Example Call

curl -H "X-Auth-Token: 8h2mKAwxB3AQrFSjLVKMooJyjdCFaA7W45sWlHP8IzO" \
     -H "X-User-Id: ew28FnZqipDpvKw3R" \
     -H "Content-type: application/json" \
     http://localhost:3000/api/v1/groups.counters?roomId=euzoT67Gx6nXcn66M

Example Response

{
  "joined":true,
  "members":1,
  "unreads":1,
  "unreadsFrom":"2018-02-18T21:51:20.091Z",
  "msgs":1,
  "latest":"2018-02-23T17:20:17.345Z",
  "userMentions":0,
  "success":true
}

//where:

//joined - boolean flag that shows that user is joined the room or not
//members - count of current room members
//unreads - count of unread messages for specified user (calling user or provided userId)
//unreadsFrom - start date-time of unread interval for specified user
//msgs - count of messages in the room
//latest - end date-time of unread interval for specified user (or date-time of last posted message)
//userMentions - count of user mentions in messages

Change Log

VersionDescription

0.65.0

Added

Last updated

Rocket.Chat versions receive support for six months after release.