Skip to content

Utilities API

Open API playground All endpoints

Fetch short-lived, signed download URLs for call recordings.

Get a recording download URL

GET/api/v1/recordings

Resolve a recording to a short-lived, signed download URL. The endpoint responds with a 302 redirect whose Location header points at the audio file; follow the redirect to download it. The signed URL expires after expires_in seconds (default 15 minutes).

Auth: x-api-key header

Parameters

NameInTypeDescription
recording_id requiredquerystring

Recording identifier (rec_ prefix) or its canonical UUID.

expires_inqueryinteger

Lifetime of the signed URL in seconds (60–86400). Defaults to 900.

Responses

StatusDescription
302

Redirect to the signed recording URL.

403

The recording does not belong to your account.

404

The recording exists but its audio is not available.

422

The request body or query parameters failed validation.