Skip to main content
GET
cURL

When to use this endpoint

Use the callId from a call.completed webhook or CALL event to download a completed call recording. This endpoint returns a temporary URL for one recording; it does not return a list of calls or recordings.

Recording availability

Call completion and recording availability are separate. If the recording is still being prepared, the endpoint returns 409 Recording is not ready yet. Retry only after a 409, using backoff and an application-defined attempt or time limit. Stop retrying and handle every other response according to its documented status.

Downloading recordings

The url expires after 15 minutes. Download the MP3 immediately and store the file in your own retention system. Do not save the URL; request a new one when it expires.

Authorizations

x-api-key
string
header
required

Path Parameters

callId
string
required

Call ID from data.callId in a call webhook or the event id in a CALL event.

Response

A temporary recording download URL was created.

A short-lived URL for downloading a call recording.

url
string<uri>
required

Temporary URL for downloading the recording. Download the file immediately; do not store this URL.

expiresAt
string<date-time>
required

When the temporary URL expires. Request a new URL after this time.

contentType
enum<string>
required

MIME type of the downloaded recording.

Available options:
audio/mpeg