# Download Call recordings using the API Reference

You can use your API key to get the public URLs to bulk-download your call recordings/voicemails using your preferable API Client.

**Getting your API Key**

First, you will need the API key of the Toky account (available to admin accounts only). Go to your name in the upper-right corner and hit the API Key option:

<figure><img src="/files/qpPrnJ505jtTF9mTBmWK" alt=""><figcaption></figcaption></figure>

Once there, you will get a floating window with the option to copy the key:

<figure><img src="/files/uwvR8t7vBW7nFlw5D4F8" alt=""><figcaption></figcaption></figure>

Once you have copied your API Key, go to our developer portal on the call recordings reference available [here](https://developer.toky.co/reference/recordings-url).

There, you can paste your API Key (exactly as it was copied from the web app, **no** extra characters added) on the field for that purpose:

<figure><img src="/files/RPAjc5p5yKCpDNF4CnTD" alt=""><figcaption></figcaption></figure>

On the Path Params, you must enter a single callid that you can get by following [this guide](https://tokyapp.zendesk.com/hc/en-us/articles/360020736197).

<figure><img src="/files/Uk6n6aeUzpneM8FSlcAr" alt=""><figcaption></figcaption></figure>

Once you have entered the two requirements, you can hit the TRY IT button. If you get a 200 response code (green) on Your request history, it means there are no errors and the process pulled the public URL correctly, which you can find on the Response section:

<figure><img src="/files/YZPz7dDCu2opRGS6BYib" alt=""><figcaption></figcaption></figure>

Once you have that response, you can use the request URL to build a script to mass-download your call recordings.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/toky-en/how-to-guidestokyapp/download-call-recordings-using-the-api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.