REST Cloud Recording API Follow

Update: Please see our Developer Portal for more up to date content on our REST API and Mobile SDK.

The following API calls go over the management and deleting of Cloud Recordings through Zooms REST API calls.

List all the cloud recording meetings on Zoom.

Endpoint:

https://api.zoom.us/v1/recording/list

Parameters:

cURL Example:

curl --data 'api_key=your_api_key&api_secret=your_api_secret&host_id=your_user_id' https://api.zoom.us/v1/recording/list

Response XML:

<?xml version="1.0" encoding="UTF-8" ?>
<result>
<page_count>7</page_count>
<page_number>1</page_number>
<page_size>2</page_size>
<total_records>13</total_records>
<meetings>
	<meeting>
		<uuid>j0N0YDBYSQ3222Ic3hQ==</uuid>
		<meeting_number>4324324423</meeting_number>
		<host_id>kEFomHcIRgqxZT8D086O6A</host_id>
		<account_id>NyEqCEoYSNOr4jLMHoO2tA</account_id>
		<topic>Rcoky test recording</topic>
		<start_time>2014-11-09T08:10:10Z</start_time>
		<timezone>America/Los_Angeles</timezone>
		<duration>99</duration>
		<total_size>4431</total_size>
		<recording_count>1</recording_count>
		<recording_files>
		<recording_file>
		<id>00401415-6783-0B14-608A-34C1DD9E3441</id>
		<meeting_id>j0N0YDBYSQ3222Ic3hQ==</meeting_id>
		<recording_start>2014-11-09T08:15:10Z</recording_start>
		<recording_end>2014-11-09T09:10:10Z</recording_end>
		<file_type>MP4</file_type>
		<file_size>432423</file_size>                  <play_url>https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3441</play_url>
		</recording_file>
		</recording_files>
	</meeting>
	<meeting>
		<uuid>j0N0YDBYSQGB4fRv2Ic3hQ==</uuid>
		<meeting_number>2565121024</meeting_number>
		<host_id>kEFomHcIRgqxZT8D086O6A</host_id>
		<topic>Rcoky test recording delete</topic>
		<start_time>2014-11-09T05:10:10Z</start_time>
		<duration>80</duration>
		<total_size>432324</total_size>
		<recording_count>2</recording_count>
		<recording_files>
		<recording_file>
		<id>00401415-6783-0B14-608A-34C1DD9E3021</id>
		<meeting_id>j0N0YDBYSQGB4fRv2Ic3hQ==</meeting_id>
		<recording_start>2014-11-13T00:59:49Z</recording_start>
		<recording_end>2014-11-13T10:59:49Z</recording_end>
		<file_type>M4A</file_type>
		<file_size>3323</file_size>  <play_url>https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3021</play_url>
		</recording_file>
		<recording_file>
		<id>00401415-6783-0B14-608A-34C1DD9E3022</id>
		<meeting_id>j0N0YDBYSQGB4fRv2Ic3hQ==</meeting_id>
		<recording_start>2014-11-13T00:59:52Z</recording_start>
		<recording_end>2014-11-13T20:59:49Z</recording_end>
		<file_type>MP4</file_type>
		<file_size>4444</file_size>                    <play_url>https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3022</play_url>
		</recording_file>
		</recording_files>
	</meeting>
</meetings>
</result>

Response JSON:

{
"page_count": 1,
"page_number": 1,
"page_size": 15,
"total_records": 1,
"meetings": [{
	"uuid": "j0N0YDBYSQGB4fRv444444==",
	"meeting_number": 7565121024,
	"host_id": "kEFomHcIRgqxZT8D086O6A",
	"account_id": "NyEqCEoYSNOr4jLMHoO2tA",
	"topic": "Rcoky test recording delete",
	"start_time": "2014-11-06T04:10:10Z",
	"timezone": "America/Los_Angeles",
	"duration": 999,
	"total_size": 4324324324,
	"recording_count": 4,
	"recording_files": [{
		"id": "00401415-6783-0B14-608A-34C1DD9E3041",
		"meeting_id": "j0N0YDBYSQGB4fRv444444==",
		"recording_start": "2014-11-06T04:14:10Z",
		"recording_end": "2014-11-06T04:24:10Z",
		"file_type": M4A,
		"file_size": 432432,
		"play_url": "https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3041"
	}, {
		"id": "00401415-6783-0B14-608A-34C1DD9E3042",
		"meeting_id": "j0N0YDBYSQGB4fRv444444==",
		"recording_start": "2014-11-06T04:25:10Z",
		"recording_end": "2014-11-06T04:26:10Z",
		"file_type": MP4,
		"file_size": 432532465,
		"play_url": "https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3042"
	}, {
		"id": "00401415-6783-0B14-608A-34C1DD9E3043",
		"meeting_id": "j0N0YDBYSQGB4fRv444444==",
		"recording_start": "2014-11-06T04:36:10Z",
		"recording_end": "2014-11-06T04:56:10Z",
		"file_type": M4A,
		"file_size": 564,
		"play_url": "https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3043"
	}, {
		"id": "00401415-6783-0B14-608A-34C1DD9E3044",
		"meeting_id": "j0N0YDBYSQGB4fRv444444==",
		"recording_start": "2014-11-06T04:56:10Z",
		"recording_end": "2014-11-06T04:56:12Z",
		"file_type": MP4,
		"file_size": 643534,
		"play_url": "https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3044"
	}]
}]
}

Lists all the cloud recordings meetings on a Meeting Connector

Endpoint:

https://api.zoom.us/v1/mc/recording/list

Parameters:

cURL Example:

curl --data 'api_key=your_api_key&api_secret=your_api_secret&host_id=your_user_id' https://api.zoom.us/v1/mc/recording/list

Response XML:

<?xml version="1.0" encoding="UTF-8" ?>
<result>
<page_count>7</page_count>
<page_number>1</page_number>
<page_size>2</page_size>
<total_records>13</total_records>
<meetings>
    <meeting>
        <uuid>j0N0YDBYSQ3222Ic3hQ==</uuid>
        <meeting_number>4324324423</meeting_number>
        <host_id>kEFomHcIRgqxZT8D086O6A</host_id>
		<account_id>NyEqCEoYSNOr4jLMHoO2tA</account_id>
        <topic>Rcoky test recording</topic>
        <start_time>2014-11-09T08:10:10Z</start_time>
    <timezone>America/Los_Angeles</timezone>
<duration>99</duration>
        <total_size>4431</total_size>
        <recording_count>1</recording_count>
        <recording_files>
            <recording_file>
                <id>00401415-6783-0B14-608A-34C1DD9E3441</id>
                <meeting_id>j0N0YDBYSQ3222Ic3hQ==</meeting_id>
                <recording_start>2014-11-09T08:15:10Z</recording_start>
                <recording_end>2014-11-09T09:10:10Z</recording_end>
				<file_type>MP4</file_type>
<file_size>432423</file_size>
<file_path>/home/cmr-ssh/replay/2015/03/27/454289936/EDB9994C-8E0D-4688-B1CE-6460F2742A10/GMT20150327-083026_test-pmem-recording.mp4 </file_path>                
</recording_file>
        </recording_files>
    </meeting>
    <meeting>
        <uuid>j0N0YDBYSQGB4fRv2Ic3hQ==</uuid>
        <meeting_number>2565121024</meeting_number>
        <host_id>kEFomHcIRgqxZT8D086O6A</host_id>
<account_id>NyEqCEoYSNOr4jLMHoO2tA</account_id>
        <topic>Rcoky test recording delete</topic>
        <start_time>2014-11-09T05:10:10Z</start_time>
        <duration>80</duration>
        <total_size>432324</total_size>
        <recording_count>2</recording_count>
        <recording_files>
            <recording_file>
                <id>00401415-6783-0B14-608A-34C1DD9E3021</id>
                <meeting_id>j0N0YDBYSQGB4fRv2Ic3hQ==</meeting_id>
                <recording_start>2014-11-13T00:59:49Z</recording_start>
                <recording_end>2014-11-13T10:59:49Z</recording_end>
<file_type>MP4</file_type>
                <file_size>3323</file_size>  <play_url>https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3021</play_url>
            </recording_file>
            <recording_file>
                <id>00401415-6783-0B14-608A-34C1DD9E3022</id>
                <meeting_id>j0N0YDBYSQGB4fRv2Ic3hQ==</meeting_id>
                <recording_start>2014-11-13T00:59:52Z</recording_start>
                <recording_end>2014-11-13T20:59:49Z</recording_end>
				<file_type>M4A</file_type>
                <file_size>4444</file_size>                    <file_path>/home/cmr-ssh/replay/2015/03/27/454289936/EDB9994C-8E0D-4688-B1CE-6460F2742A10/GMT20150327-083026_test-pmem-recording.mp4 </file_path>
            </recording_file>
        </recording_files>
    </meeting>
</meetings>
</result>

Response JSON:

{
"page_count": 1,
"page_number": 1,
"page_size": 15,
"total_records": 1,
"meetings": [{
    "uuid": "j0N0YDBYSQGB4fRv444444==",
    "meeting_number": 7565121024,
    "host_id": "kEFomHcIRgqxZT8D086O6A",
"account_id": "NyEqCEoYSNOr4jLMHoO2tA",
    "topic": "Rcoky test recording delete",
    "start_time": "2014-11-06T04:10:10Z",
"timezone": "America/Los_Angeles",
    "duration": 999,
    "total_size": 4324324324,
    "recording_count": 4,
    "recording_files": [{
        "id": "00401415-6783-0B14-608A-34C1DD9E3041",
        "meeting_id": "j0N0YDBYSQGB4fRv444444==",
        "recording_start": "2014-11-06T04:14:10Z",
        "recording_end": "2014-11-06T04:24:10Z",
"file_type": M4A,
        "file_size": 432432,
        "play_url": "https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3041"
    }, {
        "id": "00401415-6783-0B14-608A-34C1DD9E3042",
        "meeting_id": "j0N0YDBYSQGB4fRv444444==",
        "recording_start": "2014-11-06T04:25:10Z",
        "recording_end": "2014-11-06T04:26:10Z",
"file_type": MP4,
        "file_size": 432532465,
        "play_url": "https://brand.zoom.us/recording/play/00401415-6783-0B14-608A-34C1DD9E3042"
    }, {
        "id": "00401415-6783-0B14-608A-34C1DD9E3043",
        "meeting_id": "j0N0YDBYSQGB4fRv444444==",
        "recording_start": "2014-11-06T04:36:10Z",
        "recording_end": "2014-11-06T04:56:10Z",
"file_type": M4A,
        "file_size": 564,
        "file_path": "/home/cmr-ssh/replay/2015/03/27/454289936/EDB9994C-8E0D-4688-B1CE-6460F2742A10/GMT20150327-083026_test-pmem-recording.mp4"
    }, {
        "id": "00401415-6783-0B14-608A-34C1DD9E3044",
        "meeting_id": "j0N0YDBYSQGB4fRv444444==",
        "recording_start": "2014-11-06T04:56:10Z",
        "recording_end": "2014-11-06T04:56:12Z",
"file_type": MP4,
        "file_size": 643534,
        "file_path": "/home/cmr-ssh/replay/2015/03/27/454289936/EDB9994C-8E0D-4688-B1CE-6460F2742A10/GMT20150327-083026_test-pmem-recording.mp4"
    }]
}]
}

Get the recorded meeting on either Zoom's cloud or on-prem. 

Endpoint:

https://api.zoom.us/v1/recording/get

Parameters:

cURL Example:

curl --data 'api_key=your_api_key&api_secret=your_api_secret&meeting_id=meeting_uuid' https://api.zoom.us/v1/recording/get

Response XML:

<?xml version="1.0" encoding="UTF-8" ?>
<result>
    <meeting>
    <uuid>ucc69C82Q5mTNyCRWE29Aw==</uuid>
    <meeting_number>933560800</meeting_number>
    <host_id>kEFomHcIRgqxZT8D086O6A</host_id>
    <account_id>NyEqCEoYSNOr4jLMHoO2tA</account_id>
    <topic>vgfdsffdfdsf s3423432</topic>
    <start_time>2015-04-13T01:06:04Z</start_time>
    <timezone>UTC</timezone>
    <duration>1</duration>
    <total_size>686496</total_size>
    <recording_count>3</recording_count>
    <recording_files>
    <recording_file>
        <id>654234c0-ca6e-4dfd-a09d-54f85951658f</id>
        <meeting_id>ucc69C82Q5mTNyCRWE29Aw==</meeting_id>
        <recording_start>2015-04-13T01:06:36Z</recording_start>
        <recording_end>2015-04-13T01:06:47Z</recording_end>
        <file_type>MP4</file_type>
        <file_size>438482</file_size>
        <play_url>https://rocky.zoom.us/recording/play/654234c0-ca6e-4dfd-a09d-54f85951658f</play_url>
    </recording_file>
    <recording_file>
        <id>51ff09f7-e8d8-4b29-9e61-fb8e0cbc7246</id>
        <meeting_id>ucc69C82Q5mTNyCRWE29Aw==</meeting_id>
        <recording_start>2015-04-13T01:06:55Z</recording_start>
        <recording_end>2015-04-13T01:07:02Z</recording_end>
        <file_type>MP4</file_type>
        <file_size>244958</file_size>
        <play_url>https://rocky.zoom.us/recording/play/51ff09f7-e8d8-4b29-9e61-fb8e0cbc7246</play_url>
    </recording_file>
    <recording_file>
        <id>b601d00e-497a-450f-bb05-9896ce20c03e</id>
        <meeting_id>ucc69C82Q5mTNyCRWE29Aw==</meeting_id>
        <recording_start>2015-04-13T01:06:55Z</recording_start>
        <recording_end>2015-04-13T01:07:02Z</recording_end>
        <file_type>M4A</file_type>  
        <file_size>3056</file_size>
        <play_url>https://rocky.zoom.us/recording/play/b601d00e-497a-450f-bb05-9896ce20c03e</play_url>
    </recording_file>
    </recording_files>
    </meeting> 
</result>

Response JSON:

{
"uuid": "ucc69C82Q5mTNyCRWE29Aw==",
"meeting_number": 933560800,
"host_id": "kEFomHcIRgqxZT8D086O6A",
"account_id": "NyEqCEoYSNOr4jLMHoO2tA",
"topic": "vgfdsffdfdsf s3423432",
"start_time": "2015-04-13T01:06:04Z",
"timezone": "UTC",
"duration": 1,
"total_size": 686496,
"recording_count": 3,
"recording_files": [{
    "id": "654234c0-ca6e-4dfd-a09d-54f85951658f",
    "meeting_id": "ucc69C82Q5mTNyCRWE29Aw==",
    "recording_start": "2015-04-13T01:06:36Z",
    "recording_end": "2015-04-13T01:06:47Z",
    "file_type": MP4,
    "file_size": 438482,
    "play_url": "https://rocky.zoom.us/recording/play/654234c0-ca6e-4dfd-a09d-54f85951658f"
}, {
    "id": "51ff09f7-e8d8-4b29-9e61-fb8e0cbc7246",
    "meeting_id": "ucc69C82Q5mTNyCRWE29Aw==",
    "recording_start": "2015-04-13T01:06:55Z",
    "recording_end": "2015-04-13T01:07:02Z",
    "file_type": MP4,
    "file_size": 244958,
    "play_url": "https://rocky.zoom.us/recording/play/51ff09f7-e8d8-4b29-9e61-fb8e0cbc7246"
}, {
    "id": "b601d00e-497a-450f-bb05-9896ce20c03e",
    "meeting_id": "ucc69C82Q5mTNyCRWE29Aw==",
    "recording_start": "2015-04-13T01:06:55Z",
    "recording_end": "2015-04-13T01:07:02Z",
    "file_type": M4A,
    "file_size": 3056,
    "play_url": "https://rocky.zoom.us/recording/play/b601d00e-497a-450f-bb05-9896ce20c03e"
}]
}

Delete recorded meeting either on Zoom's cloud or on-prem. 

Endpoint:

https://api.zoom.us/v1/recording/delete

Parameters:

cURL Example:

curl --data 'api_key=your_api_key&api_secret=your_api_secret&meeting_id=meeting_uuid' https://api.zoom.us/v1/recording/delete

Response XML:

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <id> ucc69C82Q5mTNyCRWE29Aw==</id>
    <deleted_at>2012-11-25T12:00:00Z</deleted_at>
</result >

Response JSON:

{
"id": " ucc69C82Q5mTNyCRWE29Aw==",
"deleted_at": "2012-11-25T12:00:00Z"
}
Was this article helpful?
Have more questions? Submit a request
Powered by Zendesk