# Get recording download link

> Returns a fresh signed link to download a call's recording, valid for 60 minutes. The link works without an Allo login: do not share it beyond the people who…

`GET /v2/api/conversations/items/{id}/recording`

<Note>
**Required scope:** `CONVERSATIONS_READ`
</Note>

Returns a fresh link that downloads a call's recording, valid for 60 minutes. Use it when the `recording_download_url` you received has expired, or when you need a link on demand. The endpoint works on every account, not only on accounts created by a partner.

- `{id}` is a call ID (`cll-*`). An ID with an unrecognized prefix returns `400 INVALID_ITEM_ID`.
- `url` downloads the recording file with no Allo login. Anyone who has the link can download the recording until `expires_at`, so do not share it beyond the people allowed to hear the call.
- `expires_at` is 60 minutes after the request. Call the endpoint again for a new link.

## Who can get the link

The user of the API key must be able to play the recording in Allo: the line owner, a team admin or manager, a member the line is shared with, or the recipient of a summary share. Anyone else gets `403 RECORDING_ACCESS_DENIED`.

Allo never creates a download link for a call on a HIPAA-enabled team. Those calls return `403 RECORDING_DOWNLOAD_RESTRICTED`: listen to the recording in the Allo app instead.

## Errors

| Code | What it means |
|------|---------------|
| `CONVERSATION_ITEM_NOT_FOUND` | No call with this ID is visible to the key's user (`404`). |
| `RECORDING_NOT_FOUND` | The call has no recording, or the ID is an SMS (`msg-*`) (`404`). Only answered calls on lines with call recording on have one. |
| `RECORDING_ACCESS_DENIED` | The key's user cannot play this recording (`403`). |
| `RECORDING_DOWNLOAD_RESTRICTED` | The line belongs to a HIPAA-enabled team (`403`). |
| `RECORDING_DOWNLOAD_UNAVAILABLE` | The link could not be created (`500`). Always `retryable: true`: retry in a few seconds. |
