Logo
Zoom Public API Documentation

List user's chat messages

GET {{baseUrl}}/chat/users/:userId/messages?to_contact=<email>&to_channel=<string>&date=<date>&from=<dateTime>&to=<dateTime>&page_size=10&next_page_token=<string>&include_deleted_and_edited_message=<boolean>&search_type=file&search_key=<string>&exclude_child_message=false&download_file_formats=audio/mp4

Searches chat messages or shared files between a user and an individual contact or a chat channel. For user-level apps, pass the me value instead of the userId parameter.

Note: For an account-level OAuth app, this API can only be used on behalf of a user who is assigned with a role that has the View or Edit permission for Chat Messages.

Scopes: chat_message:read, chat_message:read:admin
Rate Limit Label: Medium

 

Body PARAM

Key Datatype Required Description 
to_contact
string This field allows you to query by the email address or user ID or member ID of a chat contact with whom the user communicated. The API only returns messages sent and/or received between the user and the queried contact. **Note:** * You must provide either the `to_contact` or the `to_channel` query parameter. * When you call the `search_key` and `search_type` query parameters, this query parameter is optional and **not** required.
to_channel
string This field queries by the channel ID of a channel in which the user had chat conversations. The API only returns messages sent and/or received by the user in the queried channel. **Note:** * You must provide either the `to_contact` or the `to_channel` query parameter. * When you call the `search_key` and `search_type` query parameters, this query parameter is optional and **not** required.
date
string The query date from which to retrieve the chat messages. This value defaults to the current date. **Note:** If you do not provide the `date` or `from` query parameters, the API defaults to the `date` query parameter.
from
string The query start date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format. **Note:** If you provide both the `date` and `from` query parameters, the API queries using the `date` value.
to
string The query end date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format. This value defaults to the current date.
page_size
Curl
curl -X GET 'https://api.zoom.us/v2/chat/users/:userId/messages?to_contact=<email>&to_channel=<string>&date=<date>&from=<dateTime>&to=<dateTime>&page_size=10&next_page_token=<string>&include_deleted_and_edited_message=<boolean>&search_type=file&search_key=<string>&exclude_child_message=false&download_file_formats=audio/mp4?to_contact=<email>&to_channel=<string>&date=<date>&from=<dateTime>&to=<dateTime>&page_size=10&next_page_token=<string>&include_deleted_and_edited_message=<boolean>&search_type=file&search_key=<string>&exclude_child_message=false&download_file_formats=audio/mp4' -H 'Accept: application/json'

ENDPOINTS