# Best way to download recording\_files programmatically

**URL:** <https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386>\
**Category:** API and Webhooks\
**Created:** [January 8, 2020, 12:49am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386 "2020-01-08T00:49:37Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![dmcquay](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/dmcquay/32/2804_2.png) [@dmcquay](https://devforum.zoom.us/u/dmcquay)\
**Post date:** [January 8, 2020, 12:49am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/1 "2020-01-08T00:49:37Z")

</div>

**Description**  
I am building an app that will allow customers to connect their zoom account to my service. My service will import their recording transcripts and do some machine learning on them. I’m trying to figure out the best way to provide this. I’m specifically struggling with auth right now.

Option 1: JWT App

If a cloud recording is not set to public, then the only way I can download the files programmatically is to use JWT auth (I think). However, I can’t get JWT auth to work. I am getting the JWT from the App Marketplace for my JWT app. I set it to be good for 1 week and I generated it today so it should be valid for sure. Then from the API documentation page for getaccountcloudrecording I am using the easy form on the page to test the request. I enter the JWT token where it asks for the oauth token. For the account ID I am entering the “Account No.” which I am retrieving from [zoom.us/profile](http://zoom.us/profile). Result is 401 status with body {“code”: 124, “message”: “Invalid access token.”}.

So first I need to figure out what I’m doing wrong with auth. However, even if I can get this to work, it is not ideal because it requires the user sharing their data to have high privileges in zoom and also they have to create their own JWT App and share the JWT with us. Much better would be to use OAuth.

Option 2: OAuth (preferred, but has problems)

With OAuth, I can download recording transcripts just fine for a single user. This is okay, actually preferable, for my use case. However, when my script tries to actually download the VTT or TIMELINE files, I run into an auth problem. OAuth token is insufficient for downloading these files if they are private or password protected. The only way I can get this to work is to set the recording sharing settings to public. Is there any way around this? It seems like the oauth token should be okay because it is for a specific user and I’m only accessing that user’s own recordings. I’m guessing this is a dead end because I’ve read in two places in your docs/forum that this limitation is real.

FYI for this option, this is an OAuth app (obviously). I’m using /v2/users/me/recordings to get recordings. That is working fine. In that response, I grabe the recording\_files that are of type TRANSCRIPT or TIMELINE. From those, I grab the download\_url and try to download. With setting bearer token to oauth token, I am rejected. If it set recording to public and omit auth header, it works. But I can’t expect my users to make all their recordings public. 😛

Option 3: Any ideas? Any other approaches I am missing?

---

<div class="post-metadata">

**Author:** ![matt](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/matt/32/802_2.png) [@matt](https://devforum.zoom.us/u/matt)\
**Post date:** [January 8, 2020, 1:43am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/2 "2020-01-08T01:43:08Z")

</div>

Join the club! [BUG downloading cloud recordings with access token set results in an invalid response](https://devforum.zoom.us/t/bug-downloading-cloud-recordings-with-access-token-set-results-in-an-invalid-response/4292/34)

---

<div class="post-metadata">

**Author:** ![dustin-mcquay](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/dustin-mcquay/32/2820_2.png) [@dustin-mcquay](https://devforum.zoom.us/u/dustin-mcquay)\
**Post date:** [January 8, 2020, 4:48pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/3 "2020-01-08T16:48:35Z")

</div>

Thanks @matt. Your post covers ALL the issues I’m facing so I’ll hop on board!

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [January 8, 2020, 10:17pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/4 "2020-01-08T22:17:56Z")

</div>

Hey @dustin-mcquay / @dmcquay, thanks for posting and using Zoom!

Option 1:

Please share your request URL you are using to download the recording so I can debug.

Option 2:

We are working to make OAuth access\_tokens work with downloading all private and password protected recording files.

Option 3:

(@matt check this out)

There is another way! 🙂 The [Recording Completed webhook](https://marketplace.zoom.us/docs/api-reference/webhook-reference/recording-events/recording-completed) for a User Level OAuth app includes a download token which you can use to download the recording programmatically.

 ![Screen Shot 2020-01-08 at 3.17.16 PM](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/2X/e/e07f3a283e0d054b41bd71f1e71dbca919929d7e.png)

Let me know if you have any luck with option 3.

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![matt](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/matt/32/802_2.png) [@matt](https://devforum.zoom.us/u/matt)\
**Post date:** [January 9, 2020, 12:12am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/5 "2020-01-09T00:12:48Z")

</div>

Hi @tommy the link I posted already mentioned the download token. #3 is what we use, but as demonstrated by [Webhook events stopped suddenly](https://devforum.zoom.us/t/webhook-events-stopped-suddenly/5354) and [`recording.*` events not being sent](https://devforum.zoom.us/t/recording-events-not-being-sent/6156), the zoom developer platform sometimes stops sending for large periods of time, which is still not communicated on [status.zoom.us](http://status.zoom.us).

This means that if oauth apps miss the webhook for any reason and the recording is password protected. That recording is inaccessible to the app.

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [January 9, 2020, 12:47am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/6 "2020-01-09T00:47:34Z")

</div>

Hey @matt,

We are working to have the status page finished in Q2 and accessing the recordings with an OAuth access\_token in March.

We appreciate all the feedback you have given to help improve the Zoom Developer Platform ! 🙂

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![dmcquay](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/dmcquay/32/2804_2.png) [@dmcquay](https://devforum.zoom.us/u/dmcquay)\
**Post date:** [January 9, 2020, 7:17am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/7 "2020-01-09T07:17:30Z")

</div>

Thanks all. Regarding option 1, I was doing something wrong and figured it out.  
I’m greatly looking forward to using option 2 (OAuth) in March!

I am aware of Option 3, but my primary use case right now is backfill, plus async comms generally need to ability to heal missed records anyway so I agree with @matt that webhook only is really not a suitable solution.

Thanks all!

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [January 9, 2020, 8:50pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/8 "2020-01-09T20:50:02Z")

</div>

Hey @dmcquay,

Happy to hear you figured out Option 1! 🙂

Thanks for the feedback,  
-Tommy

---

<div class="post-metadata">

**Author:** ![zoom-test](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/zoom-test/32/2531_2.png) [@zoom-test](https://devforum.zoom.us/u/zoom-test)\
**Post date:** [February 7, 2020, 8:52pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/9 "2020-02-07T20:52:04Z")

</div>

@tommy

This is still on track for March, right?

Do we have a read on what the new behavior will be? Will we need to just add the OAuth token as a bearer authentication token header as in how the rest of the api is interacted with?

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [February 7, 2020, 10:16pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/10 "2020-02-07T22:16:02Z")

</div>

Yes, and yes @zoom-test!

-Tommy

---

<div class="post-metadata">

**Author:** ![zoom-test](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/zoom-test/32/2531_2.png) [@zoom-test](https://devforum.zoom.us/u/zoom-test)\
**Post date:** [March 10, 2020, 4:22pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/11 "2020-03-10T16:22:08Z")

</div>

Was this shipped with the March 2nd API update?

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [March 10, 2020, 5:19pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/12 "2020-03-10T17:19:16Z")

</div>

Hey @zoom-test,

This will be included in the March 22nd release.

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![zoom-test](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/zoom-test/32/2531_2.png) [@zoom-test](https://devforum.zoom.us/u/zoom-test)\
**Post date:** [March 11, 2020, 1:21am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/13 "2020-03-11T01:21:14Z")

</div>

I did some testing on this now and it looks like if we add the bearer token now, before release then we get a nice little error:

```auto
{
    "status": false,
    "errorCode": 401,
    "errorMessage": "java.lang.IllegalArgumentException: urn:zoom:connect:clientid:REDACTED not support",
    "result": null
}

```

So I am guessing that if we implement this now then we should have it turned off until the support is released on March 22nd. Is this correct?

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [March 11, 2020, 4:22pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/14 "2020-03-11T16:22:14Z")

</div>

Hey @zoom-test,

Correct.

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![zoom-test](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/zoom-test/32/2531_2.png) [@zoom-test](https://devforum.zoom.us/u/zoom-test)\
**Post date:** [March 24, 2020, 11:01pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/15 "2020-03-24T23:01:23Z")

</div>

Did this ship on the 22nd? It no longer gives the illegalArgumentException, but still returns a login page.

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [March 25, 2020, 7:34am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/16 "2020-03-25T07:34:07Z")

</div>

Hey @zoom-test,

Our March release has been delayed due to our focus shifting on keeping the platform running smoothly with the huge increase in usage.

We don’t have a new date set in stone, but it will be included in the next release.

Stay updated here: [https://marketplace.zoom.us/docs/changelog](https://marketplace.zoom.us/docs/changelog)

Thanks for your patience,  
Tommy

---

<div class="post-metadata">

**Author:** ![hhao](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/hhao/32/8803_2.png) [@hhao](https://devforum.zoom.us/u/hhao)\
**Post date:** [April 3, 2020, 1:53am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/17 "2020-04-03T01:53:46Z")

</div>

Hi I  
am also use option 1 to get all videos download URL. But I have trouble to bulk download them. Would you please advice how do u download server videos by script instead of using the browser.  
Thank you.

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [April 3, 2020, 6:03am UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/18 "2020-04-03T06:03:37Z")

</div>

Hey @hhao,

What troubles are you running into?

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![zoom-test](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/zoom-test/32/2531_2.png) [@zoom-test](https://devforum.zoom.us/u/zoom-test)\
**Post date:** [April 3, 2020, 5:34pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/19 "2020-04-03T17:34:07Z")

</div>

@tommy is there any chance this will get shipped soon or is it going to be frozen until after the 90 day period of security updates? Not having the ability to use OAuth tokens as authentication for downloads has caused some issues in an increased traffic/latency situations. This would go a long way towards solving a lot of problems.

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [April 3, 2020, 7:07pm UTC](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386/20 "2020-04-03T19:07:25Z")

</div>

Hey @zoom-test,

Unfortunately this release has been frozen and we have no updated timeline.

Once we continue releases this will be one of the first to go out.

Really sorry for the delay  
-Tommy

[Next page](https://devforum.zoom.us/t/best-way-to-download-recording-files-programmatically/7386.md?page=2)
