List messages
GET {{baseUrl}}/v3/:channel_type/:channel_url/messages
List messages
Retrieves a list of past messages of a channel.
This message retrieval is one of Sendbird's premium features. Contact our sales team for further assistance.
https://sendbird.com/docs/chat/v3/platform-api/guides/messages#2-list-messages
channel_type
Type: string
Description: Specifies the type of the channel. Either openchannels or groupchannels.
channel_url
Type: string
Description: Specifies the URL of the channel to retrieve a list of past messages.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
message_ts | string | ||
message_id | string | ||
prev_limit | string | ||
next_limit | string | ||
include | string | ||
reverse | string | ||
sender_id | string | ||
sender_ids | string | ||
operator_filter | string | ||
custom_types | string | ||
message_type | string | ||
including_removed | string | ||
include_reactions | string | ||
with_sorted_meta_array | string | ||
show_subchannel_messages_only | string | ||
user_id | string | ||
custom_type | string | ||
with_meta_array | string |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Api-Token | string | (Required) | |
Accept | string |
RESPONSES
status: OK
{"messages":[{"message_survival_seconds":"\u003cnumber\u003e","custom_type":"\u003cstring\u003e","mentioned_users":[{"user_id":"\u003cstring\u003e","nickname":"\u003cstring\u003e","profile_url":"\u003cstring\u003e","metadata":{"anyOf":"\u003cstring\u003e"}},{"user_id":"\u003cstring\u003e","nickname":"\u003cstring\u003e","profile_url":"\u003cstring\u003e","metadata":{"anyOf":"\u003cstring\u003e"}}],"translations":"\u003cobject\u003e","updated_at":"\u003cnumber\u003e","is_op_msg":"\u003cboolean\u003e","is_removed":"\u003cboolean\u003e","user":{"require_auth_for_profile_image":"\u003cboolean\u003e","is_active":"\u003cboolean\u003e","role":"\u003cstring\u003e","user_id":"\u003cstring\u003e","nickname":"\u003cstring\u003e","profile_url":"\u003cstring\u003e","metadata":{"anyOf":"\u003cstring\u003e"}},"file":"\u003cobject\u003e","message":"\u003cstring\u003e","data":"\u003cstring\u003e","message_retention_hour":"\u003cnumber\u003e","silent":"\u003cboolean\u003e","type":"\u003cstring\u003e","created_at":"\u003cnumber\u003e","channel_type":"\u003cstring\u003e","req_id":"\u003cstring\u003e","mention_type":"\u003cstring\u003e","channel_url":"\u003cstring\u003e","message_id":"\u003cnumber\u003e","sorted_metaarray":[{"key":"\u003cstring\u003e","value":["\u003cstring\u003e","\u003cstring\u003e"]},{"key":"\u003cstring\u003e","value":["\u003cstring\u003e","\u003cstring\u003e"]}],"og_tag":{"og:url":"\u003cstring\u003e","og:title":"\u003cstring\u003e","og:description":"\u003cstring\u003e","og:image":{"url":"\u003cstring\u003e","secure_url":"\u003cstring\u003e","width":"\u003cnumber\u003e","height":"\u003cnumber\u003e"}}},{"message_survival_seconds":"\u003cnumber\u003e","custom_type":"\u003cstring\u003e","mentioned_users":[{"user_id":"\u003cstring\u003e","nickname":"\u003cstring\u003e","profile_url":"\u003cstring\u003e","metadata":{"anyOf":"\u003cstring\u003e"}},{"user_id":"\u003cstring\u003e","nickname":"\u003cstring\u003e","profile_url":"\u003cstring\u003e","metadata":{"anyOf":"\u003cstring\u003e"}}],"translations":"\u003cobject\u003e","updated_at":"\u003cnumber\u003e","is_op_msg":"\u003cboolean\u003e","is_removed":"\u003cboolean\u003e","user":{"require_auth_for_profile_image":"\u003cboolean\u003e","is_active":"\u003cboolean\u003e","role":"\u003cstring\u003e","user_id":"\u003cstring\u003e","nickname":"\u003cstring\u003e","profile_url":"\u003cstring\u003e","metadata":{"anyOf":"\u003cstring\u003e"}},"file":"\u003cobject\u003e","message":"\u003cstring\u003e","data":"\u003cstring\u003e","message_retention_hour":"\u003cnumber\u003e","silent":"\u003cboolean\u003e","type":"\u003cstring\u003e","created_at":"\u003cnumber\u003e","channel_type":"\u003cstring\u003e","req_id":"\u003cstring\u003e","mention_type":"\u003cstring\u003e","channel_url":"\u003cstring\u003e","message_id":"\u003cnumber\u003e","sorted_metaarray":[{"key":"\u003cstring\u003e","value":["\u003cstring\u003e","\u003cstring\u003e"]},{"key":"\u003cstring\u003e","value":["\u003cstring\u003e","\u003cstring\u003e"]}],"og_tag":{"og:url":"\u003cstring\u003e","og:title":"\u003cstring\u003e","og:description":"\u003cstring\u003e","og:image":{"url":"\u003cstring\u003e","secure_url":"\u003cstring\u003e","width":"\u003cnumber\u003e","height":"\u003cnumber\u003e"}}}]}