---
title: "List Webinar Recordings (Admin)"
method: GET
path: "/webinar/history/v1/company/recordings"
tags: ["Historical Recordings"]
---

# List Webinar Recordings (Admin)

`GET /webinar/history/v1/company/recordings`

Returns the list of webinar recordings (Administrator's interface).
The user must have "WebinarSettings" permission granted otherwise the API returns HTTP 403.

## Query parameters

- `nameFragment` string
- `creationTimeFrom` string, date-time, required
- `creationTimeTo` string, date-time, required
- `status` RecordingStatusModel[]
- `hostUserId` string[]
- `perPage` integer
- `pageToken` string

## Response `200`

Successful response

- RecordingAdminListResource
  - `records` RecordingAdminModel[], required
    - `id` string — Internal object ID
    - `creationTime` string, date-time, required — Object creation time
    - `lastModifiedTime` string, date-time, required — Object last modification time
    - `status` 'Processing' | 'Available' | 'Failed' | 'Purged', required — Recording status
    - `failureReason` ApiError — Generalized API error structure suitable for any error type
      - `errorCode` string, required — Logical error code (typically, 3 letters followed with number, dash separated)
      - `message` string, required — User-friendly error message
    - `duration` integer — Recording duration in seconds
    - `shared` boolean — Indicates if Host or Admin has shared a recording. Can be set to true only then recording status is 'Available'.
    - `sharedUriExpirationTime` string, date-time, nullable — Time after which recording shared link cannot be accessed by recipients.
    - `session` object
      - `id` string — Internal object ID
      - `startTime` string, date-time — Session start time. If a session hasn't been started this fields should be set to "scheduledStartTime"
      - `endTime` string, date-time — Session end time. If a session hasn't been finished this fields should be set to ("startTime"+"scheduledDuration")
      - `duration` integer — Session duration in seconds rounded up (returned if 'startTime' and 'endTime' are not empty)
      - `title` string — Session title. If blank - derived from webinar title.
      - `description` string — User-friendly description of the Session. If blank - derived from webinar title.
      - `webinar` WebinarRefModel
        - `id` string — Internal object ID
        - `title` string, required — Webinar title
        - `description` string — User-friendly description of the Webinar
        - `host` HostModel, required — The internal IDs of RC-authenticated users.
          - `firstName` string — First (given) name
          - `lastName` string — Last (family) name
          - `linkedUser` RcwDomainUserModel
            - `userId` string, required — User ID
            - `accountId` string, required — Account ID
            - `domain` 'pbx' | 'ilm', required — Identity domain
  - `paging` RcwPagingModel, required
    - `perPage` integer, required — Number of items per page
    - `pageToken` string, required — Current page token
    - `nextPageToken` string — Next page token (absent for the last page of the result set)
    - `previousPageToken` string — Previous page token (absent for the first page of the result set)

## Other responses

- `400` — General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.
- `403` — General response with **HTTP 403 "Forbidden"** status.<br> Reasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.
- `500` — General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)