---
title: "Get Recording URL"
method: GET
path: "/v2/calls/{id}/recording"
tags: ["Calls"]
---

# Get Recording URL

`GET /v2/calls/{id}/recording`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/calls/{id}/recording`
- Auth: API key in header `x-api-key`

Get recording readiness and, when ready, a signed playback URL. Setting download=true requires calls export permission and requests attachment disposition.

## Path parameters

- `id` string, uuid, required: Call ID

## Query parameters

- `channel` 'mono' | 'stereo': Which recording channel to retrieve
- `download` boolean: When true, signed S3 URLs request attachment disposition

## Response `200`

GET /v2/calls/:id/recording Positive response

- union
  - object
    - `status` 'ready', required
    - `recordingUrl` string, uri, required: Signed URL for the call recording (valid for 5 minutes). This URL provides direct access to the recording file.
    - `expiresAt` string, date-time, required: ISO timestamp when the signed URL expires
  - object
    - `status` 'processing', required
    - `recordingUrl` unknown, required
    - `expiresAt` unknown, required
  - object
    - `status` 'unavailable', required
    - `recordingUrl` unknown, required
    - `expiresAt` unknown, required

## Other responses

- `400`: GET /v2/calls/:id/recording Negative response 400
- `401`: GET /v2/calls/:id/recording Negative response 401
- `403`: GET /v2/calls/:id/recording Negative response 403
- `404`: GET /v2/calls/:id/recording Negative response 404
- `409`: GET /v2/calls/:id/recording Negative response 409
- `422`: GET /v2/calls/:id/recording Negative response 422
- `429`: GET /v2/calls/:id/recording Negative response 429
- `500`: GET /v2/calls/:id/recording Negative response 500
- `502`: GET /v2/calls/:id/recording Negative response 502
- `503`: GET /v2/calls/:id/recording Negative response 503

---

[API](https://skmtc.dev/carecycle/apis/carecycle-public-api.md) - [All operations](https://skmtc.dev/carecycle/apis/carecycle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carecycle/apis/carecycle-public-api/revisions/db390c743c36?raw)