---
title: "List recordings"
method: GET
path: "/api/relay/rest/recordings"
tags: ["Recordings"]
---

# List recordings

`GET /api/relay/rest/recordings`

Returns a list of your recordings.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Response `200`

The request has succeeded.

- RecordingListResponse — Response containing a list of recordings.
  - `links` PaginationLinks, required — Pagination links for list responses.
    - `self` string, required — Link to the current page.
    - `first` string, required — Link to the first page.
    - `next` string — Link to the next page. Only present when there are more results.
    - `prev` string — Link to the previous page. Only present when not on the first page.
  - `data` Recording[], required — List of recordings.
    - union — Recording model. A recording is associated with exactly one source type (PSTN, SIP, WebRTC, or Relay conference).
      - PstnRecording — Recording from a PSTN call leg.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `project_id` string, uuid, required — Universal Unique Identifier.
        - `created_at` string, date-time, required — Date and time when the recording was created.
        - `updated_at` string, date-time, required — Date and time when the recording was last updated.
        - `duration_in_seconds` integer, required — Duration of the recording in seconds.
        - `error_code` string — Error code if the recording failed.
        - `price` number, double, required — Price of the recording.
        - `price_unit` string, required — Currency unit for the price.
        - `status` string, required — Status of the recording.
        - `url` string, required — URL of the recording file.
        - `stereo` boolean, required — Indicates whether the recording is stereo.
        - `byte_size` integer — Size of the recording file in bytes.
        - `track` string, required — Audio track of the recording.
        - `relay_conference_id` string, uuid — Universal Unique Identifier.
        - `relay_pstn_leg_id` string, uuid, required — Universal Unique Identifier.
      - SipRecording — Recording from a SIP call leg.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `project_id` string, uuid, required — Universal Unique Identifier.
        - `created_at` string, date-time, required — Date and time when the recording was created.
        - `updated_at` string, date-time, required — Date and time when the recording was last updated.
        - `duration_in_seconds` integer, required — Duration of the recording in seconds.
        - `error_code` string — Error code if the recording failed.
        - `price` number, double, required — Price of the recording.
        - `price_unit` string, required — Currency unit for the price.
        - `status` string, required — Status of the recording.
        - `url` string, required — URL of the recording file.
        - `stereo` boolean, required — Indicates whether the recording is stereo.
        - `byte_size` integer — Size of the recording file in bytes.
        - `track` string, required — Audio track of the recording.
        - `relay_conference_id` string, uuid — Universal Unique Identifier.
        - `relay_sip_leg_id` string, uuid, required — Universal Unique Identifier.
      - WebRtcRecording — Recording from a WebRTC call leg.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `project_id` string, uuid, required — Universal Unique Identifier.
        - `created_at` string, date-time, required — Date and time when the recording was created.
        - `updated_at` string, date-time, required — Date and time when the recording was last updated.
        - `duration_in_seconds` integer, required — Duration of the recording in seconds.
        - `error_code` string — Error code if the recording failed.
        - `price` number, double, required — Price of the recording.
        - `price_unit` string, required — Currency unit for the price.
        - `status` string, required — Status of the recording.
        - `url` string, required — URL of the recording file.
        - `stereo` boolean, required — Indicates whether the recording is stereo.
        - `byte_size` integer — Size of the recording file in bytes.
        - `track` string, required — Audio track of the recording.
        - `relay_conference_id` string, uuid — Universal Unique Identifier.
        - `relay_webrtc_leg_id` string, uuid, required — Universal Unique Identifier.
      - ConferenceRecording — Recording from a Relay conference.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `project_id` string, uuid, required — Universal Unique Identifier.
        - `created_at` string, date-time, required — Date and time when the recording was created.
        - `updated_at` string, date-time, required — Date and time when the recording was last updated.
        - `duration_in_seconds` integer, required — Duration of the recording in seconds.
        - `error_code` string — Error code if the recording failed.
        - `price` number, double, required — Price of the recording.
        - `price_unit` string, required — Currency unit for the price.
        - `status` string, required — Status of the recording.
        - `url` string, required — URL of the recording file.
        - `stereo` boolean, required — Indicates whether the recording is stereo.
        - `byte_size` integer — Size of the recording file in bytes.
        - `track` string, required — Audio track of the recording.
        - `relay_conference_id` string, uuid, required — Universal Unique Identifier.

## Other responses

- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — The request failed validation. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/7a9eb5f67855/schema)