GET /users/{userId}/recordings

When a user records a meeting or a webinar by choosing the Record to the Cloud option, the video, audio, and chat text are recorded in the Zoom cloud.

Use this API to list all Cloud recordings of a user.

To access a user's password protected cloud recording, add an "access_token" parameter to the download URL and provide either the JWT or the user's OAuth access token as the value of the "access_token" parameter.

Scopes: recording:read:admin recording:read

Rate Limit Label: Medium
Prerequisites:

Pro or a higher plan.
Cloud Recording must be enabled on the user's account.

Servers

https://api.zoom.us/v2

Path parameters

Name	Type	Required	Description
`userId`	String	Yes	The user ID or email address of the user. For user-level apps, pass `me` as the value for userId.

Query parameters

Name	Type	Required	Description
`to`	String	No	End date in 'yyyy-mm-dd' 'yyyy-mm-dd' UTC format.
`page_size`	Integer	No	The number of records returned within a single API call. Default value: 30
`trash`	Boolean	No	Query trash. `true`: List recordings from trash. `false`: Do not list recordings from the trash. The default value is `false`. If you set it to `true`, you can use the `trash_type` property to indicate the type of Cloud recording that you need to retrieve. Default value: false
`next_page_token`	String	No	The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.
`mc`	String	No	Query Metadata of Recording if an On-Premise Meeting Connector was used for the meeting. Default value: "false"
`trash_type`	String	No	The type of Cloud recording that you would like to retrieve from the trash. The value can be one of the following: `meeting_recordings`: List all meeting recordings from the trash. `recording_file`: List all individual recording files from the trash. Default value: "meeting_recordings"
`from`	String	No	The start date in 'yyyy-mm-dd' UTC format for the date range for which you would like to retrieve recordings. The maximum range can be a month. If no value is provided for this field, the default will be current date. For example, if you make the API request on June 30, 2020, without providing the “from” and “to” parameters, by default the value of 'from' field will be “2020-06-30” and the value of the 'to' field will be “2020-07-01”. Note: The "trash" files cannot be filtered by date range and thus, the "from" and "to" fields should not be used for trash files.

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.