Skip to main content

Retrieve call recording

GET 

/recordings/:recording_id

Retrieves the details of an existing call recording.

Request

Path Parameters

    recording_id stringrequired

    Uniquely identifies the recording by id.

Responses

200: A response with recording resource.

Schema

    data

    object

    call_control_id string

    Unique identifier and token for controlling the call.

    call_leg_id string

    ID that is unique to the call and can be used to correlate webhook events.

    call_session_id string

    ID that is unique to the call session and can be used to correlate webhook events. Call session is a group of related call legs that logically belong to the same phone call, e.g. an inbound and outbound leg of a transferred call.

    channels string

    Possible values: [single, dual]

    When dual, final audio file has the first leg on channel A, and the rest on channel B.

    conference_id string

    Uniquely identifies the conference.

    created_at string

    ISO 8601 formatted date indicating when the resource was created.

    download_urls

    object

    The links to download the recording files.

    mp3 string

    Link to download the recording in mp3 format.

    wav string

    Link to download the recording in wav format.

    duration_millis int32

    The duration of the recording in milliseconds.

    id string

    Uniquely identifies the recording.

    record_type string

    Possible values: [recording]

    recording_started_at string

    ISO 8601 formatted date of when the recording started.

    recording_ended_at string

    ISO 8601 formatted date of when the recording ended.

    source string

    Possible values: [conference, call]

    The kind of event that led to this recording being created.

    status string

    Possible values: [completed]

    The status of the recording. Only resources for completed recordings are currently supported.

    updated_at string

    ISO 8601 formatted date indicating when the resource was updated.

default: Unexpected error.

Schema

    errors

    Error[]

  • Array [

  • code integerrequired
    title stringrequired
    detail string

    source

    object

    pointer json-pointer

    JSON pointer (RFC6901) to the offending entity.

    parameter string

    Indicates which query parameter caused the error.

    meta object
  • ]

Loading...