---
title: "List all call recordings"
method: GET
path: "/recordings"
tags: ["Call Recordings"]
---

# List all call recordings

`GET /recordings`

Returns a list of your call recordings.

## Query parameters

- `page` object
  - `number` integer — The page number to load.
  - `size` integer — The size of the page.
- `filter` object
  - `call_control_id` string — If present, recordings will be filtered to those with a matching `call_control_id`.
  - `call_leg_id` string, uuid — If present, recordings will be filtered to those with a matching call_leg_id.
  - `call_session_id` string, uuid — If present, recordings will be filtered to those with a matching call_session_id.
  - `conference_id` string — Returns only recordings associated with a given conference.
  - `conference_region` string — If present, recordings will be filtered to those with a matching `conference_region`.
  - `connection_id` string — If present, recordings will be filtered to those with a matching `connection_id` attribute (case-sensitive).
  - `created_at` object
    - `gte` string — Returns only recordings created later than or at given ISO 8601 datetime.
    - `lte` string — Returns only recordings created earlier than or at given ISO 8601 datetime.
  - `end_time` object
    - `gte` string — Returns only recordings with an end time later than or equal to the given ISO 8601 datetime.
    - `lte` string — Returns only recordings with an end time earlier than or equal to the given ISO 8601 datetime.
  - `from` string — If present, recordings will be filtered to those with a matching `from` attribute (case-sensitive).
  - `sip_call_id` string — If present, recordings will be filtered to those with a matching `sip_call_id` attribute. Matching is case-sensitive.
  - `start_time` object
    - `gte` string — Returns only recordings with a start time later than or equal to the given ISO 8601 datetime.
    - `lte` string — Returns only recordings with a start time earlier than or equal to the given ISO 8601 datetime.
  - `to` string — If present, recordings will be filtered to those with a matching `to` attribute (case-sensitive).

## Response `200`

A response containing multiple recordings.

- object
  - `data` RecordingResponseData[]
    - `call_control_id` string — Unique identifier and token for controlling the call.
    - `call_leg_id` string — ID unique to the call leg (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` 'single' | 'dual' — When `dual`, the final audio file has the first leg on channel A, and the rest on channel B.
    - `conference_id` string — Uniquely identifies the conference.
    - `connection_id` string — Identifies the Telnyx application (Call Control, TeXML) or SIP connection resource associated with this recording.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `download_urls` object — 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` integer — The duration of the recording in milliseconds.
    - `from` string — The `from` (caller) number for the call that generated this recording.
    - `id` string — Uniquely identifies the recording.
    - `initiated_by` string — Indicates what triggered the recording. Possible values include `DialVerb`, `Conference`, `OutboundAPI`, `Trunking`, `RecordVerb`, `StartCallRecordingAPI`, `StartConferenceRecordingAPI`.
    - `record_type` 'recording'
    - `recording_ended_at` string — ISO 8601 formatted date of when the recording ended.
    - `recording_started_at` string — ISO 8601 formatted date of when the recording started.
    - `source` 'conference' | 'call' — The kind of event that led to this recording being created.
    - `status` 'completed' — The status of the recording. Only `completed` recordings are currently supported.
    - `to` string — The `to` (callee) number for the call that generated this recording.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.
  - `meta` PaginationMeta
    - `page_number` integer
    - `page_size` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `401` — Unauthorized. The request lacks valid authentication credentials.
- `403` — Forbidden. The request is understood but has been refused.
- `404` — Resource not found. The requested resource or URL could not be found.
- `500` — Internal server error. An unexpected error occurred on the server.
- `default` — Unexpected error.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)