/ Platform API
Platform API
    Chat Platform API v3
    Chat Platform API
    Chat Platform API
    Version 3

    Get a banned participant of an open channel

    Copy link

    Retrieves information about a participant banned from an open channel.


    HTTP request

    Copy link
    GET https://api-{application_id}.sendbird.com/v3/open_channels/{channel_url}/ban/{banned_user_id}
    

    Parameters

    Copy link

    The following table lists the parameters that this action supports.

    Required
    Parameter nameTypeDescription

    channel_url

    string

    Specifies the URL of a channel.

    banned_user_id

    string

    Specifies the ID of a banned user.


    Response

    Copy link

    If successful, this action returns a banned user resource and ban information in the response body.

    {
        "user": {
            "user_id": "Matthew",
            "nickname": "Mooch",
            "profile_url": "https://sendbird.com/main/img/profiles/profile_47_512px.png",
            "metadata": {
                "font_preference": "times new roman",
                "font_color": "black"
            }
        },
        "start_at": 1543211469000,
        "end_at": 1543211529000,
        "description": "Too much talking"
    }
    

    List of response properties

    Copy link
    Property nameTypeDescription

    user

    object

    The user resource that contains brief information about the banned user.

    start_at

    long

    The time when the user becomes banned in the channel. The value is in Unix milliseconds format.

    end_at

    long

    The timestamp of when the ban is scheduled to end. The value is in Unix milliseconds format.

    description

    string

    The reason for the ban.

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