SKskipcall
Calls

Get call recording

Changed on

Returns the recording metadata for a call, including audioUrl: the absolute URL of GET /v1/calls/{id}/recording/audio, which streams the audio with the same API key. Returns 403 RECORDING_DISABLED when call recording is disabled for the workspace of the call (behaviour change: this endpoint previously returned the metadata in that case). Returns 404 if the call is in a workspace outside the API key scope.

get/v1/calls/{id}/recording

Request

Path parameters

idstring uuid required

Call UUID

Response

The call recording metadata

idstring required

Unique identifier of the recording

durationnumber required

Duration of the recording in seconds

startTimestring date-time required

Start time of the recording

hasTranscriptionboolean required

Indicates if a transcription exists for this recording

transcriptionStatus'PENDING' | 'IN_PROGRESS' | 'FAILED' | 'COMPLETED' nullable required

Status of the transcription if it exists

audioUrlstring required

Absolute URL of the audio stream of this recording (GET /v1/calls/{id}/recording/audio). Call it with the same API key (Authorization: Bearer sk_live_…): it is not a public or pre-signed link. Supports ?format=wav and ?download=true.

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "duration": 245,
  "startTime": "2024-01-15T10:00:00Z",
  "hasTranscription": true,
  "transcriptionStatus": "COMPLETED",
  "audioUrl": "https://api-public.skipcall.app/v1/calls/123e4567-e89b-12d3-a456-426614174000/recording/audio"
}

Changes

  • 4bda52c7f85fRevision changes
    • breaking

      removed the media type application/json for the response with the status

    • info

      added the required property to the response with the status

  • 53fb4476a55dRevision changes
    • breaking

      for the path request parameter id, the format changed from no format to uuid