List reports on a channel

Retrieves a list of reports on a channel that has offensive messages or abusive activities.

HTTP request

GET https://api-{application_id}.sendbird.com/v3/report/{channel_type}/{channel_url}

Parameters

The following table lists the parameters that this action supports.

Parameters

Required	Type	Description
channel_type	string	Specifies the type of a channel. Acceptable values are `open_channels` and `group_channels`.
channel_url	string	Specifies the URL of a channel which is reported for offensive messages or inappropriate activities.

Optional	Type	Description
token	string	Specifies a page token that indicates the starting index of results to retrieve. If not specified, the index is set to `0`.
limit	int	Specifies the number of results to return per page. Acceptable values are `1` to `100`, inclusive. (Default: `10`)

Query string example

?token=wPr94LaSpl1alE1wXAkb4dN9&limit=3

Response

If successful, this action returns a list of report resources on the channel in the response body.

Status: 200 OK

{
    "report_logs": [
        {
            "report_type": "channel",
            "report_category": "inappropriate",
            "reporting_user": {
                "user_id": "Debbie",
                "nickname": "Eclipse",
                "profile_url": "https://sendbird.com/main/img/profiles/profile_183_512px.png",
                "metadata": {
                    "font_preference": "times new roman",
                    "font_color": "black"
                }
            },
            "offending_user": null,
            "reported_message": null,
            "channel": {
                "name": "Talking dirty with me tonight...",
                "channel_url": "sendbird_group_channel_15458667_8d00f8ff213349e24b8c6e0fc17bc5111d66f0fc",
                "cover_url": "",
                "custom_type": "",
                "unread_message_count": 0,
                "unread_mention_count": 0,
                "data": "",
                "is_distinct": true,
                "is_public": false,
                "is_super": false,
                "is_ephemeral": false,
                "is_discoverable": false,
                "is_access_code_required": false,
                "member_count": 6,
                "joined_member_count": 6,
                "members": [
                    ... # A list of the channel members.
                ],
                "max_length_message": -1,
                "last_message": {
                    ... # The information of the channel's last message.
                },
                "created_at": 1568782131,
                "freeze": false
            },
            "report_description": "sexual content showing now allowed",
            "created_at": 1568923510
        },
        ... # More reports on a channel.
    ],
    "next": "dAa3Ln2TLd4E3ud4Ec5F25dFkdRp~~"
}

List of response properties

Property name	Type	Description
report_logs	nested object	A list of reports on a channel.
next	string	The value for the `token` parameter to retrieve the next page in the result set.

In the case of an error, an error object is returned. A detailed list of error codes is available here.

On this page

HTTP request Parameters Response