v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Call Recordings

List all call recordings

Returns a list of your call recordings.

get/recordings

Query parameters

numberinteger

The page number to load.

sizeinteger

The size of the page.

Consolidated page parameter (deepObject style). Originally: page[size], page[number]

call_control_idstring

If present, recordings will be filtered to those with a matching call_control_id.

call_leg_idstring uuid

If present, recordings will be filtered to those with a matching call_leg_id.

call_session_idstring uuid

If present, recordings will be filtered to those with a matching call_session_id.

conference_idstring

Returns only recordings associated with a given conference.

conference_regionstring

If present, recordings will be filtered to those with a matching conference_region.

connection_idstring

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

fromstring

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

sip_call_idstring

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

tostring

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

Filter recordings by various attributes.

{
  "call_control_id": "v3:e-31OnvjEM7Y4wvxr3TKNk8M3QyLcGZPiUIzCGtwQtOtEjY-B0urkw",
  "call_leg_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
  "call_session_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
  "conference_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
  "conference_region": "us",
  "connection_id": "175237942907135762",
  "created_at": {
    "gte": "2019-03-29T11:10:00Z",
    "lte": "2019-03-29T11:10:00Z"
  },
  "end_time": {
    "gte": "2019-03-29T11:10:00Z",
    "lte": "2019-03-29T11:10:00Z"
  },
  "from": "1234567890",
  "sip_call_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
  "start_time": {
    "gte": "2019-03-29T11:10:00Z",
    "lte": "2019-03-29T11:10:00Z"
  },
  "to": "1234567890"
}

Response

A response containing multiple recordings.

Example response

{
  "data": [
    {
      "call_control_id": "v3:e-31OnvjEM7Y4wvxr3TKNk8M3QyLcGZPiUIzCGtwQtOtEjY-B0urkw",
      "call_leg_id": "84a97d76-e40f-11ed-9074-02420a0daa69",
      "call_session_id": "84a97d76-e40f-11ed-9074-02420a0daa69",
      "channels": "dual",
      "conference_id": "84a97d76-e40f-11ed-9074-02420a0daa69",
      "connection_id": "175237942907135762",
      "created_at": "2018-02-02T22:25:27.521Z",
      "duration_millis": 60000,
      "from": "+15551234567",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "initiated_by": "StartCallRecordingAPI",
      "record_type": "recording",
      "recording_ended_at": "2019-01-23T18:10:02.574Z",
      "recording_started_at": "2019-01-23T18:10:02.574Z",
      "source": "conference",
      "status": "completed",
      "to": "+15557654321",
      "updated_at": "2018-02-02T22:25:27.521Z"
    }
  ],
  "meta": {
    "page_number": 2,
    "page_size": 25,
    "total_pages": 3,
    "total_results": 55
  }
}