---
title: "Get a call recording URL"
method: GET
path: "/v1.0/call/url/{callId}"
tags: ["Calls"]
---

# Get a call recording URL

`GET /v1.0/call/url/{callId}`

Returns a temporary download URL for the audio recording of a call.

Notes:
- The URL is valid for 1 hour.
- Caller must have manage permission on the lead this call belongs to; otherwise 400 PERMISSION_DENIED is returned.
- When the call has no recording available, the 'url' field is an empty string.

## Path parameters

- `callId` integer, required

## Headers

- `Authorization` string, required

## Response `200`

Recording URL retrieved successfully.

- CallUrlResponse — Wrapped response for GET /v1.0/call/url/{callId}. The recording URL payload is returned under the 'calls' key.
  - `calls` CallRecordingUrl — Download URL for a call recording. The URL is valid for a limited time.
    - `id` integer — ID of the call.
    - `url` string — Temporary download URL for the recording audio. Empty string when no recording is available for this call.

## Other responses

- `400` — Call does not exist, or caller has no access to the owning lead (20017 PERMISSION_DENIED).
- `401` — Missing or invalid authentication token.
- `404` — Lead does not exist (20006 LEAD_NOT_FOUND).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)