Fetch Reports of a Message

It requires the view-moderation-console permission.


Query Parameter

Example Call

curl --location 'http://localhost:3000/api/v1/moderation.reports?msgId=EbhcT4vjrCDyZuHKq' \
--header 'x-auth-token: aEO8Hw3zorBFQtAEYsNPnr67Li9-lY5kX1foen8UiiS' \
--header 'x-user-id: rbAXPnMktTFbNpwtJ' \
--data ''

Example Result


    "reports": [
            "_id": "64ef0f992c26843a68c1f785",
            "description": "test report\n",
            "reportedBy": {
                "_id": "rbAXPnMktTFbNpwtJ",
                "username": "funke.olasupo",
                "name": "Funke Olasupo",
                "createdAt": "2023-02-20T13:42:07.119Z"
            "room": {
                "_id": "5fRTXMt7DMJbpPJfhrbAXPnMktTFbNpwtJ",
                "t": "d"
            "ts": "2023-08-30T09:44:57.912Z"
    "count": 1,
    "offset": 0,
    "total": 1,
    "success": true


Any of the following errors can occur on the endpoint.

  • Authorization: Requires an authentication token for the request to be made.

  • No Permission: Occurs when the authenticated user doesn't have the view-moderation-console permission.

  • MessageId Required: Occurs when msgId is missing in the request query parameter.

    "status": "error",
    "message": "You must be logged in to do this."

Change Log

Last updated

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