---
title: "Download Call Recording"
method: GET
path: "/calls/{id}/recording"
tags: ["Calls"]
---

# Download Call Recording

`GET /calls/{id}/recording`

## Request

- Base URL: `https://api.pinnacle.sh`
- URL: `https://api.pinnacle.sh/calls/{id}/recording`
- Auth: API key in header `PINNACLE-API-KEY`

Return a short-lived signed URL for the call recording.

## Path parameters

- `id` string, required

## Query parameters

- `expires_in` integer

## Response `200`

Recording download URL.

- RecordingDownload
  - `url` string, uri, required: Short-lived signed recording URL.
  - `expires_at` string, date-time, required

## Other responses

- `400`: Validation failed. The payload has missing required fields and/or invalid types. <br> See https://zod.dev/error-formatting for more information.
- `401`: The request lacks valid authentication credentials or the provided credentials are invalid. <br> Ensure you're including a valid API key in the request headers and that your account has the necessary permissions to access this endpoint.
- `404`: The requested resource could not be found. <br> This may occur if the identifier is incorrect, the resource has been deleted, or you don't have permission to access it.
- `410`: The resource is no longer available. It may have been deleted, expired, or permanently removed after a completed lifecycle event.
- `422`: The request is valid, but the resource cannot complete the requested operation.
- `425`: The resource is not ready yet. Retry after the `Retry-After` header when present.
- `500`: An unexpected error occurred on Pinnacle's servers while processing your request. <br> If this error persists, please contact support with the request details.
- `503`: This service is temporarily unavailable. Please try again later or contact support if the issue continues.

---

[API](https://skmtc.dev/pinnacle/apis/pinnacle-2.md) - [All operations](https://skmtc.dev/pinnacle/apis/pinnacle-2/llms.txt) - [OpenAPI document](https://skmtc.dev/pinnacle/apis/pinnacle-2/revisions/45416dadab79?raw)