Skip to main content

Retrieve a call recording

GET 
/recordings/:id

Retrieves the details of an existing call recording.

Request ​

Path Parameters

    id stringrequired

    ID of the recording to retrieve

Responses ​

200: Call recording response

Schema

    data

    object

    id stringrequired

    Unique identifier of the recording

    record_type stringrequired

    The type of record being returned. This will always be recording

    call

    object

    required

    The call associated with the recording

    start_time stringrequired

    ISO 8601 formatted date of when the recording was started

    end_time stringrequired

    ISO 8601 formatted date of when the recording ended

    duration integerrequired

    The duration of the recordings in seconds

    to stringrequired

    The identifier of the callee

    from stringrequired

    The identifier of the caller

    telnyx_session_uuid stringrequired

    The unique identifier for the call session

    connection_id stringrequired

    The unique identifier of the connection associated with the call

    The call associated with the recording

    download_urls

    object

    required

    Download URLs for the call recording

    wav string

    The URL of the recording in WAV format

    Download URLs for the call recording

    created_at stringrequired

    ISO 8601 formatted date of when the call recording was created

    updated_at stringrequired

    ISO 8601 formatted date of when the call recording was last updated

401: Unauthorized

404: Resource not found

422: Unprocessable entity. Can be caused by invalid UUID format

Request samples

curl -L 'https://api.telnyx.com/recordings/:id' \
-H 'Accept: application/json'

Response samples

{
  "data": {
    "id": "string",
    "record_type": "string",
    "call": {
      "start_time": "string",
      "end_time": "string",
      "duration": 0,
      "to": "string",
      "from": "string",
      "telnyx_session_uuid": "string",
      "connection_id": "string"
    },
    "download_urls": {
      "wav": "string"
    },
    "created_at": "string",
    "updated_at": "string"
  }
}