Skip to main content

List all call recordings

GET 
/recordings

Returns a list of your call recordings.

Request​

Query Parameters

    page[page] integer

    Default value: 1

    Page number of results to load

    page[page_size] integer

    Possible values: <= 1000

    Default value: 20

    Number of results per page

    call_id string

    If present, recordings will be filtered to those with a matching call_id. Matching is case-sensitive

    from string

    If present, recordings will be filtered to those with a matching from attribute. Matching is case-sensitive

    to string

    If present, recordings will be filtered to those with a matching to attribute. Matching is case-sensitive

    telnyx_session_uuid string

    If present, recordings will be filtered to those with a matching telnyx_session_uuid attribute. Matching is case-sensitive

    connection_id string

    If present, recordings will be filtered to those with a matching connection_id attribute. Matching is case-sensitive

Responses​

200: Call Recording response

Schema

    data

    undefined[]

  • Array [

    • 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

422: Unprocessable entity. Can be caused by improper use of filters or nodes.

Request samples

curl -L 'https://api.telnyx.com/recordings' \
-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"
    }
  ]
}