Get user's IM messages

GET {{baseUrl}}/im/users/:userId/chat/messages?chat_user=<email>&channel=<string>&date=<date>&page_size=30&next_page_token=<string>

Gets IM Chat messages for a specified period of time. This API only supports Oauth2.
Scopes: imchat:read
Rate Limit Label: Medium

Deprecated: By end of 2021, Zoom is deprecating this API in favor of a consolidated set of APIs. The API will still be available for you to use, though Zoom will no longer provide support for it. For further information, see Announcements: IM APIs Deprecation.

Request Params

KeyDatatypeRequiredDescription
chat_userstringThe chat user's ID or email address.
channelstringThe IM Channel's ID.
datestringThe IM message's query date format as yyyy-MM-dd.
page_sizenumberThe number of records returned within a single API call.
next_page_tokenstringThe next page token paginates through a large set of results. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;messages&quot;:[{&quot;date_time&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;sender&quot;:&quot;\u003cstring\u003e&quot;,&quot;timestamp&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;date_time&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;sender&quot;:&quot;\u003cstring\u003e&quot;,&quot;timestamp&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;next_page_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;page_size&quot;:&quot;\u003cinteger\u003e&quot;}